Open API はじめました

始めに こんにちは。株式会社ペライチ のサーバーサイドエンジニアの永見です。 開発プロセスに Open API を導入しました。ここにその知見を書いておきます。 背景 ペライチではメインのサイト作成サービスの他に、予約や顧客管理などさまざまなサービスを扱っています。各サブサービスはマイクロサービス化しており(全部ではないけど)、Web API サーバとして稼働しています。 開発の課題として以下がありました。 課題 1 : 実装とドキュメントが一致していない API の設計を Git 外のドキュメントに記載していた まったく記載がないよりはマシですが、どうしてもメンテナンスが後手になり、 実装と乖離している状態が定常化していました。 課題 2 : フロントエンドとバックエンドの連携 開発メンバーが増え、メンバー一人でバックとフロントの両方を受けもつことが少なくなり、 フロントエンドとバックエ