API のエンドポイントやパラメータ、レスポンスの形をひとつのファイルにまとめて定義します。ここから API ドキュメントの自動生成、クライアントコードの生成、モックサーバーの用意までが機械的に行えます。
技術用語
484
OpenAPI
オープンエーピーアイ
体験区分：少しだけ触った
推奨読者レベル：Level 3-4
何をしてくれるか
どこで出会うか
API を提供する側が入出力や認証の形を YAML/JSON で公開する場面で見かけます。Swagger UI などの画面で仕様書として表示され、旧称は Swagger です。
イメージ
開発フローでの位置
仕様書を書く
ドキュメント生成
コード生成
モック・テスト
保守・更新
2026.08·ready
「OpenAPI があれば API 仕様書からコードを自動生成できますよ。」
OpenAPIの見方
485
この用語の見どころ
1
役割
API の仕様を YAML/JSON で書き表す記述形式です。
2
うれしさ
ドキュメントやコードが仕様書から自動で作れます。
3
注意点
現行版は 3.2.0 で、4.0 はまだ設計段階です。
4
どこで役立つか
API ドキュメント生成やコード自動生成の場面で使います。
5
はじめに
まずはひとつのエンドポイントを YAML で書いてみます。
6
深掘り先
JSON Schema、Swagger UI、コード生成。
非エンジニアのつまずき
- 名前が OpenAI と似すぎていて、頭の中で毎回ぶつかる。
- まずここ。
- 規約の細かいところまでは正直読み切れない。
私のコメント
- 第一印象:OpenAPI と OpenAI が名前でめちゃくちゃコンフリクトする、というのが第一印象。
- 良い点:API の標準形式なので、それに従っていればいい。細かいところは LLM に書かせられる。
- ダメな点:やっぱり名前が分かりづらい。混同する。
- 誰向けか:AI フレンドリーにするならここを必ず通ることになる。規格があるから通すべきという判断や、バージョンをどれに合わせるか、更新にどう追従するかまで含めて考える人向け。
関連用語
備考
2026-08 時点の現行版は 3.2.0（2025-09 リリース）。
F-212·term_tool
バイブコーディング図鑑