如果你和你的團隊曾經爭論過使用什麼方式構建合理 JSON 響應格式, 那麼 JSON API 就是你的 anti-bikeshedding 武器。
通過遵循共同的約定,可以提高開發效率,利用更普遍的工具,可以是你更加專注於開發重點:你的程序。
基於 JSON API 的客戶端還能夠充分利用緩存,以提升性能,有時甚至可以完全不需要網絡請求。
下面是一個使用 JSON API 發送響應(response)的示例:
{ "links": { "posts.author": { "href": "http://example.com/people/{posts.author}", "type": "people" }, "posts.comments": { "href": "http://example.com/comments/{posts.comments}", "type": "comments" } }, "posts": [{ "id": "1", "title": "Rails is Omakase", "links": { "author": "9", "comments": [ "5", "12", "17", "20" ] } }] }
頂級的 "links"
部分是可選的。 除去 "links"
部分,此響應看起來非常接近使用已經存在的 API 構建的響應。
JSON API 不僅可以用來構建響應,還包括創建和更新資源。
本文檔是一個正在進展的工作,在具體實現過程中將會有所改變。詳細信息請查看現狀頁面。
JSON API 已經在 IANA 機構完成注冊。 它的 MIME 類型是 application/vnd.api+json
。
在開始使用 JSON API 前,先查看一下JSON API 格式文檔
--------------------------------------分割線 --------------------------------------
Struts中異步傳送XML和JSON類型的數據 http://www.linuxidc.com/Linux/2013-08/88247.htm
Linux下JSON庫的編譯及代碼測試 http://www.linuxidc.com/Linux/2013-03/81607.htm
jQuery 獲取JSON數據[$.getJSON方法] http://www.linuxidc.com/Linux/2013-03/81673.htm
用jQuery以及JSON包將表單數據轉為JSON字符串 http://www.linuxidc.com/Linux/2013-01/77560.htm
在C語言中解析JSON配置文件 http://www.linuxidc.com/Linux/2014-05/101822.htm
--------------------------------------分割線 --------------------------------------