目前有谁在用 PB2 的 API？

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

这是一个创建于 4924 天前的主题，其中的信息可能已经有所发展或是发生改变。

我们计划对 PB3 中的 API 进行一些升级。

届时可能有些 API 接口输出的 JSON 内容结构会发生改变。

如果你对 API 接口有任何的建议，可以反馈到 /go/api 这里。

谢谢。

API

接口

9 条回复 1970-01-01 08:00:00 +08:00

lex

2012-04-17 10:11:27 +08:00

1. 只是单词复数的话，语义上应该是一个 relationship，指到一个数组或字典。
replies -> replies_count, topics -> topics_count

2. /api/topics/show.json 里返回的 member 不带头像信息有点郁闷，这样要显示一个带头像的帖子列表就需要访问好多次 /api/members/show.json。或者可以考虑加个 verbose 参数，默认都是简化的数据。

3. 头像地址后面的"?"好像是多余的。

phuslu

2012-04-17 10:19:15 +08:00

@lex 看起来?r=后面的数字是随机数，用来防止浏览器缓存的。验证码经常的一种手法。

lex

2012-04-17 11:05:50 +08:00

@phuslu 哦，我明白。我用 Cocoa JSON Editor 看不到"?"后面的字符，不好意思。

run2

2012-04-17 11:45:53 +08:00

r=random 还不如换成 v=用户头像版本号 (或者时间戳)，老是重读也浪费流量么，虽然也许你不在乎那个流量,但没准用户在乎。

Livid

MOD

PRO

2012-04-17 11:48:01 +08:00 via iPhone

@sobigfish it's not random, r is short for revision.

Livid

MOD

PRO

2012-04-17 11:49:25 +08:00 via iPhone

@lex better API will come with PB3, team is working on it these days. :)

run2

2012-04-17 11:52:14 +08:00

@Livid 我看@phuslu 那么说的就以为是random了，呵呵。。。原来如此

lex

2012-04-19 15:01:18 +08:00

4. 能否提供一个访问notifications的API，或只提供它的RSS地址：
http://www.v2ex.com/n/{sha1(xxx)}.xml
不过这样只能客户端不断刷新它才能实现未读提醒的功能。

第三方App要实现V2EX未读提醒的Push Notification的话，有没有什么好办法？

ratazzi

2012-04-19 15:04:05 +08:00

就用了两个接口，表示影响不大