OpenAPI

読み方は「オープンエーピーアイ」。意味と使われ方を根拠つきで確認できます。

OpenAPI
オープンエーピーアイ

公式・公的資料で確認

30秒で分かる答え

OpenAPIは、HTTP APIのエンドポイント、入力、出力、認証などを、言語に依存しない形式で記述する標準仕様です。人間向けのドキュメント生成、クライアントやサーバーのコード生成、テストなどに利用できます。APIそのものや実装フレームワークではありません。

HTTP APIのインターフェースを機械可読に記述する標準仕様

OpenAPIの意味・使い方

要点と背景

一行でいうと

HTTP APIのインターフェースを機械可読に記述する標準仕様

OpenAPIは、HTTP APIのインターフェースを人間とコンピューターが理解できるよう記述する標準仕様です。OpenAPI Initiativeの仕様では、ソースコードや実際の通信を調べなくてもサービスの能力を発見・理解できる、言語に依存しないインターフェースを定義します。OpenAPIドキュメントはJSONまたはYAMLで表現でき、パス、HTTPメソッド、パラメータ、リクエストとレスポンスのスキーマ、認証、エラーなどを記述します。これを利用して、APIドキュメント、クライアントやサーバーのコード、テスト用の入力などを生成できます。ただし、仕様書が存在することだけで、実際のAPI実装が仕様どおりであることや、認証・権限・データの安全性が保証されるわけではありません。OpenAPIはREST APIと一緒に使われることが多いものの、OpenAPIの文書がAPIの実装方式をすべて決めるわけではありません。仕様のバージョン、ドキュメントと実装の差分、機密情報の公開範囲、生成ツールの対応状況を確認します。旧称のSwaggerと関連しますが、現在のOpenAPI Specificationとの関係を分けて記録します。

使われる分野・文脈

掲載データの使用場面

API設計APIドキュメントコード生成APIテスト開発者ポータル

確認時の注意

断定を避けるポイント

OpenAPI Initiativeの現行仕様で、HTTP APIの言語非依存なインターフェース記述と利用目的を確認。OpenAPIをAPI実装やRESTそのものと同義にしない。

関連する用語

同じ分野・使用文脈から探す

根拠資料と確認状況

確認日・出典

確認状態

公式・公的資料で確認

最終確認

2026/8/22

調査した根拠と項目別の確認履歴をもとに掲載しています。

掲載方針を見る

読み方と意味を、
分けて確認。

正式名称、意味、使われる分野を分けて記録しています。