はてなブックマーク

https://swagger.io/ # はじめに 業務でOpenAPIを用いたAPI設計を行い、トップダウンでAPIを実装しました。 簡単な例を用いて一連の流れを紹介します。5分もかからずに試せると思います。 # 概要 [About Swagger Specification | Documentation | Swagger | Swagger](https://swagger.io/docs/specification/about/) ## OpenAPIとは OpenAPI仕様は、REST APIのAPI記述フォーマット。 OpenAPIファイルを使用すると、次のようなAPI全体を記述できる。 ・利用可能なエンドポイント（/users） ・各エンドポイントでの操作（GET /users、POST /users） ・操作パラメーター操作ごとの入出力 ・認証方法 ・連絡先、ライセンス