APIドキュメントの変更を監視するサービス「Hitch」&「API Changelog」
れこ氏から共有していただいたAPIの監視サービスに登録して触った結果分かったことは。
これからの大API時代にめっちゃ便利なサービスなのでは、ということ。
今日のメモは
Hitchと
www.hitchhq.com
API Changelogである
API Documentation Change Notifications: API Changelog
運営会社はどちらのサービスとも同じで、API Changelogから始まり、Hitchを展開したそう。
▼このブログ読めばそこら辺が分かる。
https://blog.hitchhq.com/api-changelog-hitch-fb6191e93250#.i8kfguvsy
あと、API Changelogの機能はHitchに統合されているみたい。
何ができるの?
* APIの変更を監視できる。具体的に言うと、変更点のログがマイページに溜まっていく、メールやら何やらで通知がくる。
* APIを登録できる。swaggerかRAMLで書かれたドキュメントをリンクさせれば自動で変更した差分を検出してくれる。
* 検出した差分は、JsonやXmlでも差分を返せるっぽい。
とりあえずHitchを使ってみた。
マイページにフォローしたAPIの情報が流れてくる。
差分表示はこんな感じで分かりやすそう。
大御所のサービスは一通りフォローできた。
APIドキュメントを登録したいとことだが、まだ自分個人でAPIドキュメントを登録できるようなサービスは運営していない、、。
なので、HELPに目を通した。
登録したAPIの情報は権限管理ができる。
APIドキュメントの紐付け画面はこんな感じらしい。
簡単にできそう。
試せていないのでちょっと誤解あるかも。
英語を読み間違えている可能性もあるので、いつか試そう。
マネタイズは組織に対して課金。チーム運用すると月額が発生する。
その分、チーム内でドキュメントの管理とかできる。
▼契約に応じてできることの一覧
APIの書き方はswaggerとかに統一すべき、とHELPに書いてあったので、オレオレ仕様に苦労することもあったのだろうなあと邪推。
Hitchは多分今後も使う。
【今日のひとこと】
厚切り英単語を購入した。
480円分以上は英語を覚えられる気がする。