└── README.md /README.md: -------------------------------------------------------------------------------- 1 | # V2EX-API 2 | 3 | 做项目时用到的API整理，欢迎提交补充。 4 | 5 | # 目录 6 | 7 | * [1.API](#1) 8 | * [1.1 每天热门帖子](#1.1) 9 | * [1.2 每天最新帖子](#1.2) 10 | * [1.3 帖子下的回复](#1.3) 11 | * [1.4 所有节点](#1.4) 12 | * [1.5 节点详情](#1.5) 13 | * [1.6 根据节点名获取所有帖子](#1.6) 14 | * [1.7 用户详情](#1.7) 15 | * [1.8 用户发的帖子](#1.8) 16 | 17 | #### 域名 18 | > 域名地址 ：https://www.v2ex.com/api/ 19 | 20 |

1.API

21 |

1.1 每天热门帖子

22 | 23 | #### 接口说明 24 | > 获取每天热门帖子 25 | 26 | #### 请求 27 | > [GET] topics/hot.json 28 | 29 | #### 例子 30 | > https://www.v2ex.com/api/topics/hot.json 31 | 32 | #### 返回结构 33 | ``` 34 | { 35 | "id" : 316762, 36 | "title" : "讲真，你们为什么要买 macbook？", 37 | "url" : "http://www.v2ex.com/t/316762", 38 | "content" : "我不是程序员，我不是美工，我也不是什么艺术家，反正的我的职业和 iworks 没有半毛钱关系，我前年买了一台 macbook air ，港行 5900 人民币，买的唯一原因是为了体验一下装逼的感觉，现在已经习惯了 osx 的风格，我来谈谈优点：\u000D\u000A1 ，那个时候貌似 6000 的超级本选择面很窄\u000D\u000A2 ， macbook air 让我体验到了开盖即用，盒盖即待机的体验，习惯之后已经和手机和 pad 一样，没有关机的概念\u000D\u000A3 ，轻便，适合客厅沙发党\u000D\u000A4 ，待机时间长，再也不会可以用再拖一根尾巴\u000D\u000A5 ，鼠标扔了\u000D\u000A6 ，能屏幕镜像到 apple tv\u000D\u000A\u000D\u000A不过， air 这条产品线不知道将来是否还存在， Pro 太贵了，我也不需要，这个价格我更情愿买 windows 本，比如 surfacebook ，讲真，是不是 macbook 今后的发展方向只是专业人士？像我这种轻度用户是不是都应该用 ipad 去？但是 ipad 上如何下载种子后让迅雷下载？我在 mac 上操作的事情之一就是下载种子。。。。", 39 | "content_rendered" : "我不是程序员，我不是美工，我也不是什么艺术家，反正的我的职业和 iworks 没有半毛钱关系，我前年买了一台 macbook air ，港行 5900 人民币，买的唯一原因是为了体验一下装逼的感觉，现在已经习惯了 osx 的风格，我来谈谈优点：\u000D\u003Cbr /\u003E1 ，那个时候貌似 6000 的超级本选择面很窄\u000D\u003Cbr /\u003E2 ， macbook air 让我体验到了开盖即用，盒盖即待机的体验，习惯之后已经和手机和 pad 一样，没有关机的概念\u000D\u003Cbr /\u003E3 ，轻便，适合客厅沙发党\u000D\u003Cbr /\u003E4 ，待机时间长，再也不会可以用再拖一根尾巴\u000D\u003Cbr /\u003E5 ，鼠标扔了\u000D\u003Cbr /\u003E6 ，能屏幕镜像到 apple tv\u000D\u003Cbr /\u003E\u000D\u003Cbr /\u003E不过， air 这条产品线不知道将来是否还存在， Pro 太贵了，我也不需要，这个价格我更情愿买 windows 本，比如 surfacebook ，讲真，是不是 macbook 今后的发展方向只是专业人士？像我这种轻度用户是不是都应该用 ipad 去？但是 ipad 上如何下载种子后让迅雷下载？我在 mac 上操作的事情之一就是下载种子。。。。", 40 | "replies" : 119, 41 | "member" : { 42 | "id" : 102617, 43 | "username" : "cyberdaemon", 44 | "tagline" : "", 45 | "avatar_mini" : "//cdn.v2ex.co/avatar/2e1b/24a6/102617_mini.png?m=1444979047", 46 | "avatar_normal" : "//cdn.v2ex.co/avatar/2e1b/24a6/102617_normal.png?m=1444979047", 47 | "avatar_large" : "//cdn.v2ex.co/avatar/2e1b/24a6/102617_large.png?m=1444979047" 48 | }, 49 | "node" : { 50 | "id" : 10, 51 | "name" : "mbp", 52 | "title" : "MacBook Pro", 53 | "title_alternative" : "MacBook Pro", 54 | "url" : "http://www.v2ex.com/go/mbp", 55 | "topics" : 2458, 56 | "avatar_mini" : "//cdn.v2ex.co/navatar/d3d9/4468/10_mini.png?m=1469591623", 57 | "avatar_normal" : "//cdn.v2ex.co/navatar/d3d9/4468/10_normal.png?m=1469591623", 58 | "avatar_large" : "//cdn.v2ex.co/navatar/d3d9/4468/10_large.png?m=1469591623" 59 | }, 60 | "created" : 1477889507, 61 | "last_modified" : 1477889507, 62 | "last_touched" : 1477969664 63 | } 64 | ``` 65 |

1.2 每天最新帖子

66 | 67 | #### 接口说明 68 | > 获取每天最新帖子 69 | 70 | #### 请求 71 | > [GET] topics/latest.json 72 | 73 | #### 例子 74 | > https://www.v2ex.com/api/topics/latest.json 75 | 76 | #### 返回结构 77 | >与热门帖子相同 78 | 79 |

1.3 帖子下的回复

80 | 81 | #### 接口说明 82 | > 获取帖子下的回复 83 | 84 | #### 请求 85 | > [GET] topics/hot.json 86 | 87 | #### 参数列表 88 | > body 89 | 90 | |*Name*|*Type*|*Description*|*Required*| 91 | |---|---|---|---| 92 | |topic_id|int|帖子id|Y| 93 | 94 | #### 例子 95 | > https://www.v2ex.com/api/replies/show.json?topic_id=316762 96 | 97 | #### 返回结构 98 | ``` 99 | { 100 | "id" : 3705429, 101 | "thanks" : 0, 102 | "content" : "装逼，保值，开发设计两不误…", 103 | "content_rendered" : "装逼，保值，开发设计两不误…", 104 | "member" : { 105 | "id" : 158373, 106 | "username" : "mzh", 107 | "tagline" : "None", 108 | "avatar_mini" : "//cdn.v2ex.co/gravatar/b7e702f599cb0b47fd10479f9d07339b?s=24&d=retro", 109 | "avatar_normal" : "//cdn.v2ex.co/gravatar/b7e702f599cb0b47fd10479f9d07339b?s=48&d=retro", 110 | "avatar_large" : "//cdn.v2ex.co/gravatar/b7e702f599cb0b47fd10479f9d07339b?s=73&d=retro" 111 | }, 112 | "created" : 1477889683, 113 | "last_modified" : 1477889683 114 | } 115 | ``` 116 | 117 |

1.4 所有节点

118 | 119 | #### 接口说明 120 | > 获取所有节点信息 121 | 122 | #### 请求 123 | > [GET] nodes/all.json 124 | 125 | #### 参数列表 126 | > body 127 | 128 | |*Name*|*Type*|*Description*|*Required*| 129 | |---|---|---|---| 130 | |name|string|节点名字|Y| 131 | 132 | #### 例子 133 | > https://www.v2ex.com/api/nodes/all.json 134 | 135 | #### 返回结构 136 | ``` 137 | { 138 | "id" : 1, 139 | "name" : "babel", 140 | "url" : "http://www.v2ex.com/go/babel", 141 | "title" : "Project Babel", 142 | "title_alternative" : "Project Babel", 143 | "topics" : 1119, 144 | "header" : "Project Babel \u002D 帮助你在云平台上搭建自己的社区", 145 | "footer" : "V2EX 基于 Project Babel 驱动。Project Babel 是用 Python 语言写成的，运行于 Google App Engine 云计算平台上的社区软件。Project Babel 当前开发分支 2.5。最新版本可以从 \u003Ca href\u003D\u0022http://github.com/livid/v2ex\u0022 target\u003D\u0022_blank\u0022\u003EGitHub\u003C/a\u003E 获取。", 146 | "created" : 1272206882 147 | } 148 | ``` 149 |

1.5 节点详情

150 | 151 | #### 接口说明 152 | > 获取节点详情 153 | 154 | #### 请求 155 | > [GET] nodes/show.json 156 | 157 | #### 例子 158 | > https://www.v2ex.com/api/nodes/all.json?name=python 159 | 160 | #### 返回结构 161 | >与所有节点返回结构相同 162 | 163 |

1.6 根据节点名获取所有帖子

164 | 165 | #### 接口说明 166 | > 根据节点名获取该节点下的所有帖子 167 | 168 | #### 请求 169 | > [GET] topics/show.json 170 | 171 | #### 参数列表 172 | > body 173 | 174 | |*Name*|*Type*|*Description*|*Required*| 175 | |---|---|---|---| 176 | |node_name|string|节点名字|Y| 177 | 178 | #### 例子 179 | > https://www.v2ex.com/api/topics/show.json?node_name=python 180 | 181 | #### 返回结构 182 | >与每天热门帖子结构相同 183 | 184 |

1.7 用户详情

185 | 186 | #### 接口说明 187 | > 获取用户详情 188 | 189 | #### 请求 190 | > [GET] members/show.json 191 | 192 | #### 参数列表 193 | > body 194 | 195 | |*Name*|*Type*|*Description*|*Required*| 196 | |---|---|---|---| 197 | |username|string|用户名|Y| 198 | 199 | #### 例子 200 | > https://www.v2ex.com/api/members/show.json?username=Livid 201 | 202 | #### 返回结构 203 | ``` 204 | { 205 | "status" : "found", 206 | "id" : 1, 207 | "url" : "http://www.v2ex.com/member/Livid", 208 | "username" : "Livid", 209 | "website" : "", 210 | "twitter" : "", 211 | "psn" : "", 212 | "github" : "", 213 | "btc" : "", 214 | "location" : "91789", 215 | "tagline" : "Gravitated and spellbound", 216 | "bio" : "I’ve managed to make something I could call my own world, over time, little by little. And when I’m inside it, I feel kind of relieved.", 217 | "avatar_mini" : "//cdn.v2ex.co/avatar/c4ca/4238/1_mini.png?m=1466415272", 218 | "avatar_normal" : "//cdn.v2ex.co/avatar/c4ca/4238/1_normal.png?m=1466415272", 219 | "avatar_large" : "//cdn.v2ex.co/avatar/c4ca/4238/1_large.png?m=1466415272", 220 | "created" : 1272203146 221 | } 222 | ``` 223 | 224 |

1.8 用户发的帖子

225 | 226 | #### 接口说明 227 | > 获取用户发的帖子 228 | 229 | #### 请求 230 | > [GET] topics/show.json 231 | 232 | #### 参数列表 233 | > body 234 | 235 | |*Name*|*Type*|*Description*|*Required*| 236 | |---|---|---|---| 237 | |username|string|用户名|Y| 238 | 239 | #### 例子 240 | > https://www.v2ex.com/api/topics/show.json?username=Livid 241 | 242 | #### 返回结构 243 | >与每天热门帖子结构相同 244 | --------------------------------------------------------------------------------