V2EX API 接口

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 大每天的内容。

https://www.v2ex.com/api/topics/hot.json

  • Method: GET
  • Authentication: None

最新主题

相当于首页的“全部”这个 tab 下的最新内容。

https://www.v2ex.com/api/topics/latest.json

  • Method: GET
  • Authentication: None

节点信息

获得指定节点的名字,简介,URL 及头像图片的地址。

https://www.v2ex.com/api/nodes/show.json

  • Method: GET
  • Authentication: None

接受参数:

  • name: 节点名(V2EX 的节点名全是半角英文或者数字)

例如:

https://www.v2ex.com/api/nodes/show.json?name=python


用户主页

获得指定用户的自我介绍,及其登记的社交网站信息。

https://www.v2ex.com/api/members/show.json

  • Method: GET
  • Authentication: None

接受以下参数之一:

  • username: 用户名
  • id: 用户在 V2EX 的数字 ID

例如:

https://www.v2ex.com/api/members/show.json?username=Livid
https://www.v2ex.com/api/members/show.json?id=1

2014-08-28  ·  2875648 次查看  ·  V2EX