はじめに
WebAPI界のWikipediaを目指しているAPIS.GURUにApitoreのWebAPIを登録しました(承認待ち)。今回はその登録方法をシェアします。
やってみた
Swagger等でWebAPIのSpecをURLで公開している必要があります。WebAPIのSpecを公開していない人は、まずはそこから始めましょう。何気にSpecを公開することが最大の障害かも?最悪、DropBoxとかGithubとかでSpec公開してもイケるかも?ちなみにApitoreの場合は、https://api.apitore.com/json/N
のN
にAPIの固有IDを入れればWebAPI Specをjsonで取れるようになっています。
さて、登録手続きに移ります。こちらのページの「Add API」をクリックします。
すると、こんなページに移ります。「Specのフォーマット」「公式フォーマットかどうか」「APIの名前」「SpecのURL」を入力します。参考までに私の入力内容を下図に示します。なお、対応している「Specのフォーマット」は以下になります。
- Swagger 1.x
- Swagger 2.0
- I/O Docs
- API Bluepring
- Google API Discovery
- RAML
- WADL
「Add API」を押すと、GitHubのIssuesに飛びます。自動処理しているかもしれないので、特にいじらず「Submit」します。 以上です。
おわりに
簡単に登録が完了しました。完全に日本語のAPIなので、承認されるか分かりません。承認されたら追記します。・・・日本向けに同様のサービス作ってもいいかもしれませんね。作ろうかな。