darcy
V2EX  ›  API

V2EX API意见及建议

  •  
  •   darcy · Apr 27, 2012 · 8722 views
    This topic created in 5128 days ago, the information mentioned may be changed or developed.
    昨天晚上拿V2EX的API玩了一下,随即发现一些问题。给@Livid发了邮件,但只说当时发现的了一个小问题。
    刚开始的时候没有在网站上找着API的集中说明页面,随即去翻了PB2的源代码,得知有如下接口,其中标识broken的在PB3里无法使用或者疑似无法使用。
    [01]: /api/site/stats.json
    [02]: /api/site/info.json
    [03]: /api/nodes/all.json
    [04]: /api/nodes/show.json?id=1
    [05]: /api/topics/latest.json
    [06]: /api/topics/show.json?id=1 (broken)
    [07]: /api/topics/show.json?username=Livid
    [08]: /api/topics/show.json?node_id=1
    [09]: /api/topics/create.json (POST,未测试)
    [10]: /api/replies/show.json?topic_id=1
    [11]: /api/members/show.json?username=Livid

    相关问题:
    1.[05]latest只会返回最后20条信息,无法翻页读取更多信息。

    2.返回的topics信息里面,带有member信息,但是不带有member的avatar,如过需要,只能使用[11]额外逐一拉取一次用户信息,对于需要显示头像信息的移动设备应用来说,代价太高。

    3.缺乏批量接口。如上,额外拉取用户信息不一定不妥,但多次发起请求来拉取非常损耗性能,希望能增加一个批量拉取接口,应用可以一次拉取多个用户数据,减少请求数。

    4.有发表接口,没有回复接口。

    5.接口直接吐出数据,不带有任何状态信息。这个Livid已经在 /t/32414 中有所考虑了。

    PS:希望新增加或者更新的接口不影响现有接口。

    -EOF-
    28 replies    2019-01-03 17:38:01 +08:00
    Livid
        1
    Livid  
    MOD
    PRO
       Apr 27, 2012
    非常感谢反馈。

    目前 API 部分的状态是:

    - 我们移植了 PB2 的所有接口,但是还没有做过测试
    - 目前只有读取方面的 API

    API 部分的计划是:

    - 我会在本周末对所有 API 进行一次完整测试和修复
    - API 1.0 会在 5 月和文档一起正式上线
    - 届时会提供给大家一个测试专用的服务器地址

    非常抱歉目前有些接口不能正常工作。

    cc @Kai
    Kai
        2
    Kai  
       Apr 27, 2012
    嗯,五月份完整的 API 上线时,需要一段时间的性能测试。

    非常感谢 @darcy 同学 :)
    gDD
        3
    gDD  
       Apr 27, 2012
    @Kai @Livid 希望能有JSONP的callback=xxx参数。

    http://en.wikipedia.org/wiki/JSONP
    Livid
        4
    Livid  
    MOD
    PRO
       Apr 27, 2012
    @gDD 会有的,之前 PB2 上是有 JSONP 支持的。这个部分我们接下来也会做移植。
    Livid
        5
    Livid  
    MOD
    PRO
       Apr 27, 2012
    @darcy

    - 你提到的 broken 的 [6] 现在已经修复: http://www.v2ex.com/api/topics/show.json?id=1

    - 现在 topics/show 和 replies/show 中都已经带上了 member 和 node 的头像文件地址

    接下来需要解决和实现的:

    - 目前 V2EX 还没有任何写入接口。如何防止写入接口被 abusing,还需要思考一段时间。

    - 所有的读取接口,在分页和检查更新的实现上,将会参考 Twitter API 的实现方式。

    谢谢 @darcy ,如果发现任何新问题,或是有任何新想法,请随时告诉我。:)
    darcy
        6
    darcy  
    OP
       Apr 27, 2012
    @Livid @Kai 非常感谢你们所做的工作!
    早上的时候还有在做一个额外的头像信息拉取工作,这样一来现在已经可以不用做了,节省了不少带宽。
    yyfearth
        7
    yyfearth  
       Apr 27, 2012
    @Livid 一些比较有用的API应该尽快加上,不过难度在于用户的Auth(login)。
    然后就是 获取用户的通知,添加、取消 收藏 这个应该不会有滥用的情况
    尤其是前者比较有用
    sharkli
        8
    sharkli  
       Apr 28, 2012
    @Livid topics/latest.json 返回的member里面是不是也需要image url
    darcy
        9
    darcy  
    OP
       Apr 29, 2012
    @Livid
    latest.json返回结果里["node"]["url"]节点下的内容疑似未编码,导致JSON转换失败

    darcy
        10
    darcy  
    OP
       Apr 29, 2012
    @Livid
    在返回的topic信息里,有"content"和"content_rendered"两个字段分布返回原文及以html解析后的内容,但是在
    [10]: /api/replies/show.json?topic_id=1
    只有一个"content"字段,且是返回的以html解析后;内容与原意不一致,请帮忙处理一下,提供一下原文数据。
    Livid
        11
    Livid  
    MOD
    PRO
       Apr 29, 2012
    @darcy 收到,现在马上解决。
    Livid
        12
    Livid  
    MOD
    PRO
       Apr 29, 2012
    @darcy

    - topics/latest.json 里的问题修正了
    - replies/show.json 中现在可以同时输出 content 和 content_rendered

    Thank you. :)
    darcy
        13
    darcy  
    OP
       May 1, 2012
    @Livid
    今天在遇到点问题:
    /api/topics/show.json?node_id=142

    node_id等141/143都没问题,均能返回该节点下主题列表,但是节点id为142时就返回的时一篇帖子内容,估计是单个数据时未作为list来处理。

    ["node"]["url"]出现同9楼类似的问题。

    Thanks for your help.
    Livid
        14
    Livid  
    MOD
    PRO
       May 1, 2012
    @darcy 好的,我现在就看看。
    Livid
        15
    Livid  
    MOD
    PRO
       May 1, 2012
    @darcy 明白了,现在开始解决:

    - 出现单个主题时,也作为 list 返回
    - template 中的 node_url 的错误
    Livid
        16
    Livid  
    MOD
    PRO
       May 1, 2012
    @darcy 这两个问题好了。

    非常感谢你的反馈。:)
    darcy
        17
    darcy  
    OP
       May 3, 2012
    @Livid 嘿,偶又来打扰了。
    是否可以提供发帖及评论API了呢?对于滥用限制方面极端情况下采用百名单得了
    另盼翻页功能/读取收藏夹及收藏功能/读取提醒列表功能
    darcy
        18
    darcy  
    OP
       May 4, 2012
    @Livid @Kai 还有关注列表哈 ^_^
    Livid
        19
    Livid  
    MOD
    PRO
       May 4, 2012
    @darcy 好的,收到。
    vanemu
        20
    vanemu  
       Jun 1, 2012
    @Livid 5月份已经过去了,API 1.0 发布了吗?还是跳票了?
    darcy
        21
    darcy  
    OP
       Jul 26, 2012
    Hi, @Livid @Kai API近期有望出来么,还是说你们会出官方的APP?
    Kai
        22
    Kai  
       Jul 27, 2012
    @darcy API 部分还在进行中 ...
    xhinking
        23
    xhinking  
       Sep 24, 2012
    @Kai 啊,都已经快10月,API在哪...
    xhinking
        24
    xhinking  
       Dec 18, 2012
    @Livid @Kai

    已经235天了。。无力了。。
    imwower
        25
    imwower  
       May 25, 2013
    哦no, 都3年了..
    favormm
        26
    favormm  
       Nov 19, 2013
    PB3的api还没有出来呀?
    LINAICAI
        27
    LINAICAI  
       Nov 9, 2016
    求出登录、发帖、评论等接口,想写手机客户端, api 目前太少了。
    fgcui
        28
    fgcui  
       Jan 3, 2019
    同求最新的接口
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   5425 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 82ms · UTC 09:33 · PVG 17:33 · LAX 02:33 · JFK 05:33
    ♥ Do have faith in what you're doing.