API 公平使用规则
在你开始使用 V2EX API 之前,请了解我们关于 API 公平使用方面的规则:
- 我们鼓励将 V2EX API 用于学术研究、手机应用及浏览器扩展
- 我们反对将 API 输出的结果用于填充你的商业或是个人网站的内容。如果你对于本条规则有疑问,可以到 V2EX 元节点讨论。我们对于 API 的一切有意义的用途持开放态度,只是不希望 V2EX 的数据被用在垃圾站和 content farm
- V2EX 不会删除或是更改已经发布的 API 接口的 URI 及字段名
- 大部分 API 会带有每小时请求数量限制,但是因为大部分 API 请求是可以被 CDN 缓存的,所以可用请求数只会在第一次请求时从配额中减去
关于 API 使用的讨论,可以到以下 meta 节点:
http://www.v2ex.com/go/v2ex
API Rate Limit
默认情况下,每个 IP 每小时可以发起的 API 请求数被限制在 120 次。你可以在 API 返回结果的 HTTP 头部找到 Rate Limit 信息:
X-Rate-Limit-Limit: 120
X-Rate-Limit-Reset: 1409479200
X-Rate-Limit-Remaining: 116
对于能够被 CDN 缓存的 API 请求,只有第一次请求时,才会消耗 Rate Limit 配额。
最热主题
相当于首页右侧的 10 大每天的内容。
/api/topics/hot.json
- Method: GET
- Authentication: None
最新主题
相当于首页的“全部”这个 tab 下的最新内容。
/api/topics/latest.json
- Method: GET
- Authentication: None
节点信息
获得指定节点的名字,简介,URL 及头像图片的地址。
/api/nodes/show.json
- Method: GET
- Authentication: None
接受参数:
- name: 节点名(V2EX 的节点名全是半角英文或者数字)
例如:
/api/nodes/show.json?name=python
用户主页
获得指定用户的自我介绍,及其登记的社交网站信息。
/api/members/show.json
- Method: GET
- Authentication: None
接受以下参数之一:
- username: 用户名
- id: 用户在 V2EX 的数字 ID
例如:
/api/members/show.json?username=Livid
/api/members/show.json?id=1