サーバーサイドエンジニアのいわむ(@k_iwamu)です! 実は来月AWS re:Inventに参加してきます!弊社は海外カンファレンス補助が充実しているので、そういった配慮に感謝してたくさんのことを学んできます! さて、社内ではFammを中心としたいくつかのサービスや社内システムで複数のAPIが開発されています。会社の規模も大きくなるにつれ、それぞれのサービスを社内のエンジニアで分担しながら作っています。 そうした中で、2つの課題があげられるようになりました。 - サービスごとにAPIドキュメントの運用方法やフォーマットが統一されておらず、管理が難しい状況になっている - APIドキュメントをホスティングするためにサーバーが立ち上がっており、その管理も必要になっている そこで考えられた方針が、Swaggerを使ってドキュメントを統一化し、S3を使ってホスティングする方法です。理由は以下で
![Swagger + CircleCI + S3 Static website hosting を使ってAPIドキュメントをサーバーレスで運用する - Tech Blog](https://cdn-ak-scissors.b.st-hatena.com/image/square/89d23ec26aaf20d29da91b5abb9561475a7ef6c7/height=288;version=1;width=512/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fk%2Fkohei_iwamura%2F20191112%2F20191112123828.png)