php 豆瓣api_豆瓣网api使用方式

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