>豆瓣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`