バックエンドとフロントエンドでREST APIスキーマを簡単に共有する。【OpenAPI】 #REST-API

かなり今更感が強いですがOpenAPIについて薄い記事を書きます。

OpenAPIはRest APIのスキーマを定義する規格ですが、それをもとに自動でAPIのドキュメントを生成したり
API ClientのSDKを自動生成することができます。（APIリクエストするコードを描く必要はありません。）

REST APIのスキーマを開発前から定義しておくことでバックエンドの開発を待たずに
フロントエンドの開発を進めることも可能です。
フロントエンドのAPI Client SDKはAxios、Fetch、Redux-queryなどメジャーなものはほぼサポートされています。

また、バックエンド側でStubを利用してOpenAPIのスキーマを自動生成することも可能です。
サーバー側のStubが利用可能なフレームワークは以下の通りです。

自動生成されたAPIのドキュメント（Swagger）