ポケモンのRest-APIをswagger-uiで可視化してgithub pagesで公開

API定義ではSwagger Editorを活用していましたが、Web上で公開出来ないのか!?

どうやら Swagger-Ui を使えば、githubに簡単に公開出来るようなのでやってみました。

ローカル環境はSwagger Editorで定義しつつ、github pagesに公開するまでの手順メモ。

Swagger-uiをクローン

一応ココに置いてあります。

swagger-api/swagger-ui

が、私はこちらからstyleごと拝借しました。

swagger-pages-sample

あとは自分が作成したyamlファイルを上書きするだけ。

Swagger-uiのテーマ

Qiitaの記事内で紹介されているリンクは既に無くなっていました。

で探してみると こちらのリンク先 に色んなスタイルがありました。

index.htmlのcssを修正すれば適用されます。

github pagesにアップロード

以前にも github-pagesにアップロード しましたが、今回もプロジェクトサイトで運用。

https://username.github.io/repository/でアクセス可能。

Pokémon Restful API Swagger

こちらも使ってるのはhtml+css+js+yamlだけなので簡単に運用できます。