增加了稿件投诉的api (#407)

@@ -0,0 +1,306 @@

1 # 稿件投诉

2

3 ---

4

5 - [附件上传](#附件上传)

6 - [获取投诉类型](#获取投诉类型)

7 - [投诉稿件](#投诉稿件)

8

9 ---

10

11 ## 附件上传

12

13 > 附件上传与视频封面上传共用一个api。

14

15 ## 获取投诉类型

16

17 > https://api.bilibili.com/x/web-interface/archive/appeal/tags

18

19 *请求类型：GET*

20

21 **json回复：**

22

23 | 参数名 | 类型 | 内容 | 备注 |

24 | ------- | ------------- | ---- | ------- |

25 | code | num | | 成功为0 |

26 | message | str | | 成功为0 |

27 | ttl | num | 1 | |

28 | data | List\<object> | | |

29

30 `data`数组：

31

32 | 项 | 类型 | 内容 | 备注 |

33 | ---- | ---- | -------------- | ------------------ |

34 | 0 | obj | 评论条目 1 | |

35 | n | obj | 评论条目 (n+1) | 按照指定的顺序排列 |

36 | …… | obj | …… | …… |

37

38 `data`数组中的对象

39

40 | 项 | 类型 | 内容 | 备注 |

41 | -------- | ------------------------------ | ---------------- | -------- |

42 | tid | num | 类型tid | |

43 | business | num | | 意义不明 |

44 | weight | num | 权重 | |

45 | round | num | | 意义不明 |

46 | state | num | | 意义不明 |

47 | name | str | 类型名称 | |

48 | remark | str | 类型备注 | |

49 | ctime | str | | 意义不明 |

50 | mtime | str | | 意义不明 |

52

53 `data`数组中的对象中的`controls`对象：

54

55 | 项 | 类型 | 内容 | 备注 |

56 | ----------- | ---- | -------------- | -------- |

57 | tid | num | 同上 | |

58 | bid | num | | 意义不明 |

59 | name | str | 提示名称 | |

60 | title | str | 提示标题 | |

61 | component | str | 需要填入的类型 | |

62 | placeholder | str | 文本框占位符 | |

63 | required | num | 是否为必填 | |

64

65 **示例：**

66

67 ```bash

68 curl --location --request GET 'https://api.bilibili.com/x/web-interface/archive/appeal/tags'

69 ```

70

71 <details>

72 <summary>查看响应示例</summary>

73 ```json

74 {

75 "code": 0,

76 "message": "0",

77 "ttl": 1,

78 "data": [

79 {

80 "tid": 1,

81 "business": 1,

82 "weight": 1,

83 "round": 2,

84 "state": 1,

85 "name": "有其他问题",

86 "remark": "为帮助审核人员更快处理，请补充问题类型和出现位置等详细信息",

87 "ctime": "2018-08-13T15:41:20+08:00",

88 "mtime": "2018-08-13T15:41:20+08:00",

89 "controls": null

90 },

91 {

92 "tid": 9,

93 "business": 1,

94 "weight": 30,

95 "round": 2,

96 "state": 1,

97 "name": "引战",

98 "remark": "为帮助审核人员更快处理, 请补充引战的话题和出现位置",

99 "ctime": "2018-08-13T15:41:20+08:00",

100 "mtime": "2018-08-13T15:41:20+08:00",

101 "controls": null

102 },

103 {

104 "tid": 10,

105 "business": 1,

106 "weight": 20,

107 "round": 2,

108 "state": 1,

109 "name": "不能参加充电",

110 "remark": "为帮助审核人员更快处理, 请补充问题类型和出现位置等详细信息",

111 "ctime": "2018-08-13T15:41:20+08:00",

112 "mtime": "2018-08-23T11:35:28+08:00",

113 "controls": null

114 },

115 {

116 "tid": 52,

117 "business": 1,

118 "weight": 35,

119 "round": 2,

120 "state": 1,

121 "name": "转载/自制类型错误",

122 "remark": "为帮助审核人员更快处理, 请补充原创作品出处",

123 "ctime": "2018-08-13T15:41:20+08:00",

124 "mtime": "2018-08-13T15:41:20+08:00",

125 "controls": [

126 {

127 "tid": 52,

128 "bid": 1,

129 "name": "出处",

130 "title": "原创视频出处",

131 "component": "link",

132 "placeholder": "请填写链接",

133 "required": 1

134 }

135 ]

136 },

137 {

138 "tid": 2,

139 "business": 1,

140 "weight": 100,

141 "round": 1,

142 "state": 1,

143 "name": "违法违禁",

144 "remark": "为帮助审核人员更快处理，补充违规内容出现位置",

145 "ctime": "2018-08-13T15:41:20+08:00",

146 "mtime": "2018-08-13T15:41:20+08:00",

147 "controls": null

148 },

149 {

150 "tid": 3,

151 "business": 1,

152 "weight": 90,

153 "round": 1,

154 "state": 1,

155 "name": "色情",

156 "remark": "为帮助审核人员更快处理，补充违规内容出现位置",

157 "ctime": "2018-08-13T15:41:20+08:00",

158 "mtime": "2018-08-13T15:41:20+08:00",

159 "controls": null

160 },

161 {

162 "tid": 4,

163 "business": 1,

164 "weight": 80,

165 "round": 1,

166 "state": 1,

167 "name": "低俗",

168 "remark": "为帮助审核人员更快处理，补充违规内容出现位置",

169 "ctime": "2018-08-13T15:41:20+08:00",

170 "mtime": "2018-08-13T15:41:20+08:00",

171 "controls": null

172 },

173 {

174 "tid": 5,

175 "business": 1,

176 "weight": 70,

177 "round": 1,

178 "state": 1,

179 "name": "赌博诈骗",

180 "remark": "为帮助审核人员更快处理，补充违规内容出现位置",

181 "ctime": "2018-08-13T15:41:20+08:00",

182 "mtime": "2018-08-13T15:41:20+08:00",

183 "controls": null

184 },

185 {

186 "tid": 6,

187 "business": 1,

188 "weight": 60,

189 "round": 1,

190 "state": 1,

191 "name": "血腥暴力",

192 "remark": "为帮助审核人员更快处理，补充违规内容出现位置",

193 "ctime": "2018-08-13T15:41:20+08:00",

194 "mtime": "2018-08-13T15:41:20+08:00",

195 "controls": null

196 },

197 {

198 "tid": 7,

199 "business": 1,

200 "weight": 50,

201 "round": 1,

202 "state": 1,

203 "name": "人身攻击",

204 "remark": "为帮助审核人员更快处理，补充违规内容出现位置",

205 "ctime": "2018-08-13T15:41:20+08:00",

206 "mtime": "2018-08-13T15:41:20+08:00",

207 "controls": null

208 },

209 {

210 "tid": 8,

211 "business": 1,

212 "weight": 40,

213 "round": 1,

214 "state": 1,

215 "name": "与站内其他视频撞车",

216 "remark": "为帮助审核人员更快处理, 请描述撞车信息",

217 "ctime": "2018-08-13T15:41:20+08:00",

218 "mtime": "2018-08-23T00:30:04+08:00",

219 "controls": [

220 {

221 "tid": 8,

222 "bid": 1,

223 "name": "撞车对象",

224 "title": "撞车对象",

225 "component": "input",

226 "placeholder": "BVID",

227 "required": 1

228 }

229 ]

230 },

231 {

232 "tid": 10000,

233 "business": 1,

234 "weight": 10,

235 "round": 1,

236 "state": 1,

237 "name": "青少年不良信息",

238 "remark": "为帮助审核人员更快处理, 请补充违规内容出现位置",

239 "ctime": "2018-08-13T15:41:20+08:00",

240 "mtime": "2018-08-13T15:41:20+08:00",

241 "controls": null

242 },

243 {

244 "tid": 10013,

245 "business": 1,

246 "weight": 37,

247 "round": 1,

248 "state": 1,

249 "name": "不良封面/标题",

250 "remark": "为帮助审核人员更快处理, 请描述详细信息",

251 "ctime": "2019-04-17T19:18:09+08:00",

252 "mtime": "2019-04-17T20:42:25+08:00",

253 "controls": null

254 }

255 ]

256 }

257 ```

258 </details>

259

260 ## 投诉稿件

261

262 > https://api.bilibili.com/x/web-interface/archive/appeal

263

264 *请求方式：POST*

265

266 认证方式：Cookie（SESSDATA)

267

268 **正文参数：**

269

270 | 参数名 | 类型 | 内容 | 必要性 | 备注 |

271 | ------ | ---- | ------------------------ | ------ | ------------------------ |

272 | csrf | str | csrf token(位于cookie) | 必要 | 在url params中 |

273 | jsonp | str | jsonp | 必要? | 意义不明，位于url params |

274 | aid | num | 稿件aid | 必要 | 位于request body |

275 | tid | num | 投诉理由tid | 必要 | 位于request body |

276 | desc | str | 投诉理由详细描述 | 必要 | 位于request body |

277 | attach | str | 附件（多个附件用逗号隔开 | 非必要 | 位于request body |

278

279 **json回复：**

280

281 | 参数名 | 类型 | 内容 | 备注 |

282 | ------- | ---- | ------ | ------- |

283 | code | num | 返回码 | 成功为0 |

284 | message | str | | 成功为0 |

285 | ttl | | 1 | |

286

287

**示例：举报av号为61080066的视频，理由为人身攻击，描述为“xxxxx”，并附带了一个图片附件

288

289 ```bash

290 curl --location --request POST 'https://api.bilibili.com/x/web-interface/archive/appeal?jsonp=jsonp&csrf=xxxx' \

291 --form 'aid="61080066"' \

292 --form 'tid="7"' \

293 --form 'desc="xxxxx"' \

294 --form 'attach="https://archive.biliimg.com/bfs/archive/xxxxx.png"'

295 ```

296

297 <details>

298 <summary>查看响应示例</summary>

299 ```json

300 {

301 "code":0,

302 "message":"0",

303 "ttl":1

304 }

305 ```

306 </details>

bilibili-API-collect

增加了稿件投诉的api (#407)

代码差异