>豆瓣api舉例遵守如下規范 應該盡量將API部署在專用域名之下 `http://api.douban.com/v2/user/1000001?apikey=XXX` 應該將API的版本號放入URL，這里版本號是V2 `http://api.douban.com/v2/user/1000001?apikey=XXX` 在RESTful架構中，每個網址代表一種資源（resource），所以網址中不能有動詞，只能有名詞，而且所用的名詞往往與數據庫的表格名對應。一般來說，數據庫中的表都是同種記錄的"集合"（collection），所以API中的名詞也應該使用復數。這里指的就是表名 `http://api.douban.com/v2/book/:id` (獲取圖書信息) `http://api.douban.com/v2/movie/subject/:id` (電影條目信息) `http://api.douban.com/v2/music/:id` (獲取音樂信息) `http://api.douban.com/v2/event/:id` (獲取同城活動) >拋送方式 對于資源的具體操作類型，由HTTP動詞表示。常用的HTTP動詞有下面四個(對應增/刪/改/查)。 GET（select）：從服務器取出資源（一項或多項）。 eg. 獲取圖書信息 GET `http://api.douban.com/v2/book/:id` POST（create）：在服務器新建一個資源。 eg. 用戶收藏某本圖書 POST `http://api.douban.com/v2/book/:id/collection` PUT（update）：在服務器更新資源（客戶端提供改變后的完整資源）。 eg. 用戶修改對某本圖書的收藏 PUT `http://api.douban.com/v2/book/:id/collection` DELETE（delete）：從服務器刪除資源。 eg. 用戶刪除某篇筆記 DELETE `http://api.douban.com/v2/book/annotation/:id` 如果記錄數量很多，服務器不可能都將它們返回給用戶。API應該提供參數，過濾返回結果 `?limit=10`：指定返回記錄的數量 eg. 獲取圖書信息 GET `http://api.douban.com/v2/book/:id?limit=10`