V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
fanzeyi
V2EX  ›  API

V2EX API 文档 (Non-official)

  •  
  •   fanzeyi ·
    fanzeyi · 2013-10-13 00:18:53 +08:00 · 9712 次点击
    这是一个创建于 4131 天前的主题,其中的信息可能已经有所发展或是发生改变。

    V2EX API Documents

    Site

    site/stats.json

    URL: http://www.v2ex.com/api/site/stats.json

    获取社区统计信息。

    参数

    None

    返回值

    • topic_max - 当前社区话题数量
    • member_max - 当前社区用户数量

    site/info.json

    URL: http://www.v2ex.com/api/site/info.json

    获取社区介绍。

    参数

    None

    返回值

    • title - 当前社区站名
    • slogan - 当前社区口号
    • description - 当前社区描述
    • domain - 社区网址

    Node

    nodes/all.json

    URL: http://www.v2ex.com/api/nodes/all.json

    获取全部节点

    参数

    None

    返回值

    • id - 节点 ID
    • name - 节点缩略名
    • url - 节点地址
    • title - 节点名称
    • title_alternative - 备选节点名称
    • topics - 节点主题总数
    • header - 节点头部信息
    • footer - 节点脚部信息
    • created - 节点创建时间

    nodes/show.json

    URL: http://www.v2ex.com/api/nodes/show.json

    获取单个节点信息

    参数

    • id - 节点 id
    • name - 节点缩略名

    (以上参数任选其一)

    返回值

    • id - 节点 ID
    • name - 节点缩略名
    • url - 节点地址
    • title - 节点名称
    • title_alternative - 备选节点名称
    • topics - 节点主题总数
    • header - 节点头部信息
    • footer - 节点脚部信息
    • created - 节点创建时间

    Topic

    topics/latest.json

    URL: http://www.v2ex.com/api/topics/latest.json

    参数

    None

    返回值

    • id - Topic ID
    • title - Topic 标题
    • content - Topic 内容
    • content_rendered - 渲染过的 Topic 内容(比如 gist, Youtube 等)
    • replies - 回复数量

    topics/show.json

    URL: http://www.v2ex.com/api/topics/show.json

    参数

    • id - Topic ID

    返回值

    • id - Topic ID
    • title - Topic 标题
    • content - Topic 内容
    • content_rendered - 渲染过的 Topic 内容(比如 gist, Youtube 等)
    • replies - 回复数量

    replies/show.json

    URL: http://www.v2ex.com/api/replies/show.json

    参数

    • topic_id - Topic ID

    返回值

    • id - Reply ID
    • content - Reply 内容
    • content_rendered - 渲染过的 Reply 内容(比如 gist, Youtube 等)
    • thank - 感谢数量

    Member

    member/show.json

    URL: http://www.v2ex.com/api/members/show.json

    参数

    • id - Member ID
    • username - Member name

    (以上参数任选其一)

    返回值

    • status
    • id
    • url
    • username
    • website
    • twitter
    • location
    • tagline
    • bio
    view raw v2ex_api.md hosted with ❤ by GitHub


    Gist URL: gist.github.com/fanzeyi/6951803

    很久之前自己整理的,一直没丢出来,应该是没有遗漏的。
    9 条回复    2019-05-09 15:56:13 +08:00
    Archangel_SDY
        1
    Archangel_SDY  
       2013-10-13 00:38:06 +08:00
    感谢分享.

    另外测出一个Bug, 不带参直接访问http://www.v2ex.com/api/topics/show.json的话会抛异常.

    @Livid
    dreampuf
        2
    dreampuf  
       2013-10-13 02:51:09 +08:00
    好东西就是好,连文档都有人补刀
    Livid
        3
    Livid  
    MOD
       2013-10-13 03:38:27 +08:00 via iPhone
    :-)
    dichengsiyu
        4
    dichengsiyu  
       2013-10-21 12:42:50 +08:00
    @Livid @fanzeyi 现在其他的api功能有了么?thx
    messense
        5
    messense  
       2013-11-08 22:23:53 +08:00
    /api/nodes/all.json 和 /api/nodes/show.json 返回的数据不带 node 的 avatar 反而 /api/topics/latest.json 返回的 topic 的 node 带了,好坑。
    favormm
        6
    favormm  
       2013-11-19 11:47:39 +08:00
    WildCat
        7
    WildCat  
       2014-02-11 23:15:06 +08:00
    @Livid
    前辈您好,不知最近是否有V2EX的API完善计划?
    在写iOS客户端的时候面临一些问题:
    1.topics/latest.json ,好像忽略掉了一些节点的topic
    2.好像没有单个节点下的topics列表,也没有分页
    3.topics/show.json 和 replies/show.json能否合并为一个请求?

    感谢
    favormm
        8
    favormm  
       2014-02-27 14:27:59 +08:00
    @Livid
    api/nodes/all.json
    为何不返回topic icon的URL呢?
    v2Next
        9
    v2Next  
       2019-05-09 15:56:13 +08:00
    test reply
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1896 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 29ms · UTC 02:14 · PVG 10:14 · LAX 18:14 · JFK 21:14
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.