Formats for Hypermedia JSON
APIが返すデータにリンクを含めるメリットについてはこの辺りを見ると良いと思う。
- Web APIにもリンクをつけよう - Google スライド
- Hypermedia: The Missing Element to Building Adaptable Web APIs in Rai…
- クックパッドとマイクロサービス - クックパッド開発者ブログ
- RESTful Web API 開発をささえる Garage - クックパッド開発者ブログ
フォーマット
JSONにリンクを含めるためのフォーマットはいくつかあるが、
- JSON-LD
- HAL
- UBER
あたりが有力っぽい。
人気
Google Trendsで調べてみた。
今後どうなるのか
今後シェアを握っていくフォーマットがどれになるのか気になって簡単に調べてみたが、ものすごく雑に調べた結果だとJSON-LDとHALの2強っぽい感じ。
検索件数ではJSON-LDの方が多いけど、GarageはHALを採用してるみたいだし、hypermicrodataもHALとUBERに対応している。
インターフェイスに関わる問題だけに一度採用すると簡単に変更できないので、早めにデファクトスタンダードが決まると嬉しいと思う。