Ba.とWEBと梅干し太郎

WEB制作・プログラミング・音楽の学習したこと・つくったもののアウトプットブログです。あとは日記。

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に統合されているみたい。
f:id:masayannuu:20160930002351p:plain

何ができるの?
* APIの変更を監視できる。具体的に言うと、変更点のログがマイページに溜まっていく、メールやら何やらで通知がくる。
* APIを登録できる。swaggerかRAMLで書かれたドキュメントをリンクさせれば自動で変更した差分を検出してくれる。
* 検出した差分は、JsonXmlでも差分を返せるっぽい。

とりあえずHitchを使ってみた。
マイページにフォローしたAPIの情報が流れてくる。
f:id:masayannuu:20160930001108p:plain

差分表示はこんな感じで分かりやすそう。
f:id:masayannuu:20160930001525p:plain

大御所のサービスは一通りフォローできた。
f:id:masayannuu:20160930001626p:plain

f:id:masayannuu:20160930001641p:plain

APIドキュメントを登録したいとことだが、まだ自分個人でAPIドキュメントを登録できるようなサービスは運営していない、、。
なので、HELPに目を通した。
f:id:masayannuu:20160930002000p:plain
登録したAPIの情報は権限管理ができる。

APIドキュメントの紐付け画面はこんな感じらしい。
f:id:masayannuu:20160930001832p:plain 簡単にできそう。

試せていないのでちょっと誤解あるかも。
英語を読み間違えている可能性もあるので、いつか試そう。

マネタイズは組織に対して課金。チーム運用すると月額が発生する。
その分、チーム内でドキュメントの管理とかできる。
▼契約に応じてできることの一覧
f:id:masayannuu:20160930003900p:plain

APIの書き方はswaggerとかに統一すべき、とHELPに書いてあったので、オレオレ仕様に苦労することもあったのだろうなあと邪推。
Hitchは多分今後も使う。

【今日のひとこと】
厚切り英単語を購入した。
480円分以上は英語を覚えられる気がする。

https://i.guggy.com/KbCFuySvKB.gif