エンジニアの佐野です。 最近Laravelを利用しているプロジェクトで、API開発を行うタスクが湧きました。 API開発するにあたって、ドキュメント化する必要があったり、流行りのSchema駆動開発を取り入れたかったり……この辺りの問題を解決するべく技術選定を行いました。 まず、試したみたライブラリがこちら github.com コード上にコメントアノテーションでドキュメントを残していくというものです。 お手軽にできてよかったのですが、記述が冗長になりがち、mock serverを作って利用するといったことができない、と要件を満たせなかったので見送り。 ここで悩んでいたところ、弊社代表の富田から1冊の雑誌を手渡されました WEB+DB PRESS Vol.108|技術評論社 こちらを読み込んでみて、OpenAPIもといSwaggerの存在を知り導入してみたところ良い感じに要件を満たせ、導入
![OpenAPIを導入してみた話(sample project付属) - Inside BuildIt](https://cdn-ak-scissors.b.st-hatena.com/image/square/f75044646e823e95a5a997202caccaaa0a09da62/height=288;version=1;width=512/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fj%2Fjalemy%2F20200330%2F20200330115624.png)