OpenAPI仕様は、Linux FoundationCollaborativeProjectであるOpenAPIInitiative内のコミュニティ主導のオープン仕様です。
OpenAPI仕様(OAS)は、HTTP APIの標準的なプログラミング言語に依存しないインターフェイス記述を定義します。これにより、人間とコンピューターの両方が、ソースコードへのアクセス、追加のドキュメント、またはネットワークトラフィックの検査を必要とせずに、サービスの機能を検出して理解できます。 。OpenAPIを介して適切に定義されている場合、コンシューマーは最小限の実装ロジックでリモートサービスを理解して対話できます。インターフェース記述が低レベルのプログラミングに対して行ったことと同様に、OpenAPI仕様は、サービスを呼び出す際の当て推量を排除します。
機械可読API定義ドキュメントのユースケースには、次のものが含まれますが、これらに限定されません。ドキュメント、クライアント、およびサーバーのコード生成。テストケースの自動化。OpenAPIドキュメントはAPIサービスを記述し、YAMLまたはJSON形式で表されます。これらのドキュメントは、静的に作成および提供することも、アプリケーションから動的に生成することもできます。
OpenAPI仕様では、既存のAPIを書き換える必要はありません。ソフトウェアをサービスにバインドする必要はありません。説明されているサービスは、その説明の作成者が所有している場合もありません。ただし、サービスの機能をOpenAPI仕様の構造で説明する必要があります。すべてのサービスをOpenAPIで記述できるわけではありません。この仕様は、HTTP APIのすべての可能なスタイルを網羅することを意図したものではありませんが、RESTAPIのサポートは含まれています。OpenAPI仕様では、デザインファーストやコードファーストなどの特定の開発プロセスは義務付けられていません。HTTP APIとの明確な相互作用を確立することにより、どちらの手法も容易にします。
このGitHubプロジェクトは、OpenAPIの開始点です。ここでは、OpenAPI仕様について必要な情報、その外観の簡単な例、およびプロジェクトに関するいくつかの一般的な情報を見つけることができます。
OpenAPI仕様の現在のバージョンは、OpenAPI仕様3.1.0です。
このリポジトリには、以前のすべてのバージョンも含まれています。
例やスキーマなど、このリポジトリ内の各フォルダには、仕様の現在および以前のバージョンに関連するフォルダが含まれている必要があります。
それが機能することを確認したいだけの場合は、現在の例のリストを確認してください。
独自のOpenAPI定義を作成したり、提示したり、その他の方法で使用したりする方法をお探しですか?増え続ける実装のリストを確認してください 。
OpenAPI仕様の開発の現在のプロセスは、 開発ガイドラインで説明されています。OpenAPI仕様の次のバージョンの開発は、技術運営委員会(TSC)によって指導されています。このコミッターのグループは、APIの専門知識をもたらし、コミュニティからのフィードバックを取り入れ、必要に応じてコミッターのグループを拡大します。将来の仕様に関するすべての開発活動は機能として実行され、このブランチにマージされます。将来の仕様のリリース時に、このブランチはにマージされ
mainます。
TSCは、オープンプルリクエストを確認し、進化するOpenAPI仕様に関連する未解決の問題について話し合うために、毎週Web会議を開催しています。毎週の電話やスケジュールされた作業セッションへの参加は、コミュニティに開かれています。OpenAPI技術会議カレンダー全体をオンラインで表示できます。
OpenAPIイニシアチブは、個人と企業の両方からの参加を奨励しています。OpenAPI仕様の進化に参加したい場合は、次のアクションを実行することを検討してください。
すべてのフィードバックに対応できるわけではなく、仕様に適した変更に賛成または反対の確固たる議論があるかもしれません。