序章

OpenAPI 仕様 (OAS) は、HTTP API への言語に依存しない標準的なインターフェイスを定義しています。これにより、人間とコンピューターの両方が、ソース コードやドキュメントにアクセスしたり、ネットワーク トラフィック検査を介したりすることなく、サービスの機能を発見して理解できるようになります。適切に定義すると、コンシューマーは最小限の実装ロジックでリモート サービスを理解し、操作できるようになります。

OpenAPI 定義は、API を表示するドキュメント生成ツール、さまざまなプログラミング言語でサーバーとクライアントを生成するコード生成ツール、テスト ツール、その他多くのユースケースで使用できます。