OpenAPI GeneratorでRESTful APIの定義書から色々自動生成する #OpenAPI - こまぶろ

APIの定義を書く：Excel仕様書はもういやだ RESTful APIを提供するサーバと、そのAPIを利用するクライアント（たとえばSPA）とを並行で開発しようとするとき、まずAPIを定義して、それに基づいてサーバ／クライアント双方の実装を進めようと考えるのは自然だと思う。 そうと決まれば、「API仕様書_20190110.xlsx」と題するファイルを新規作成し、シート別にリソース毎の定義を書き始め・・・てはいけない。せっかくAPIを定義したドキュメントを作成するなら、するのなら、ソースコードの自動生成などの恩恵も受けたい。受けられるはずだ。 少しググってみる。どうやらSwaggerというものを使えばいいらしい。Swaggerに興味を持ったタイミングで、ちょうど書店に平積みになっていた『WEB+DB PRESS Vol.108』の表紙が目に入った。そこには、「スキーマ駆動Web API開

[bump_sunbear]

go-swaggerとかだと実務レベルのコード吐いてくれるので便利。

[inouetakumon]

Swagger試そう試そうと思って試してないから、この記事みて参考にしよう

[ledsun]

dockerイメージも公開されているので、docker経由でよければ、OpenAPI Generatorもインストールせずに使えるよ

[takamii228]

Swagger 2.0から結構変わってそう

[kic-yuuki]

Swagger Viewerなんてあったのか

[salamander_jp]

OpenAPI Generator4.0.0でテンプレエンジンが使いやすくなった

[miguchi]

“Swagger Editor”

[RabbitBit]

HTTP通信のオーバーヘッドを考えると、RESTfulなAPI自体の有用性が問われてくるのかもしれない。ただ、現状での解としては、成熟を感じさせる良い製品と思った。

[tawachan39]

swaggerエディターあったのか

[oqzl]

覚えておく

[momozukuuuu]

読む。