読者です 読者をやめる 読者になる 読者になる

Swagger UI に自分の yaml を getで読み込ませる

Swagger

最近気にいって使っている Swagger ですが、yaml を テキストボックスに入力して Explore で指定できるのに getで指定するやり方がわからなかったのでメモ。

パラメーター名は url でした。 ※当然ですが本当はyamlのURLはURLエンコードしたほうがいいです。

http://petstore.swagger.io/?url=http://example.com/sample/swagger.yaml

サーバーと同じリポジトリでstaticで読めるところにコミットしてサーバーデプロイ時にも同じバージョンに更新されるようにするか、

チーム内にしか共有できない場合は Git の Web UI の Raw の URL を直接指定すると ファイルへのアクセス権がない人に見えないのでよいかと。

一応、デモ用サーバーな気がするので本当は自分で1台立てといたほうがいいと思います。