返回提交历史
Modified
docs/dynamic/action.md
+59
-0
Modified
docs/dynamic/space.md
+4
-0
XFEstudio/bilibili-API-collect
feat: 置顶动态
close #1270
4d20cae
代码差异
2 个文件
+63
-0
@@ -229,3 +229,62 @@ curl 'https://api.vc.bilibili.com/dynamic_draft/v1/dynamic_draft/rm_draft' \
229
229
```
230
230
231
231
</details>
232
233
## 置顶动态
234
235
> https://api.bilibili.com/x/dynamic/feed/space/set_top
236
237
**请求方法: POST**
238
239
认证方式: Cookie (SESSDATA)
240
241
**URL 参数:**
242
243
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
244
| ------ | ------ | ------ | ------ | ---- |
245
| csrf | string | CSRF Token (即 Cookie 中 bili_jct) | 必要 | |
246
247
**正文参数 (application/json):**
248
249
根对象:
250
251
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
252
| ------- | ------ | -------- | ------ | ---- |
253
| dyn_str | string | 动态 id | 必要 | |
254
255
**JSON回复:**
256
257
根对象:
258
259
| 字段 | 类型 | 内容 | 备注 |
260
| ---- | ------ | ---- | ---- |
261
| code | number | 返回值 | 0: 成功<br />-101: 账号未登录<br />-111: csrf 校验失败<br />4100001: 参数错误 |
262
| message | string | 错误消息 | 成功时为 `0` |
263
| ttl | number | `1` | |
264
| data | object | 空对象 | |
265
266
**示例:**
267
268
269
置顶动态 `1063487284684259332`
270
271
```shell
272
curl -X POST 'https://api.bilibili.com/x/dynamic/feed/space/set_top' \
273
--url-query 'csrf=xxx' \
274
-b 'SESSDATA=xxxxx' \
275
-H 'content-type: application/json' \
276
--data-raw '{"dyn_str":"1063487284684259332"}'
277
```
278
<details>
279
<summary>查看响应示例:</summary>
280
281
```json
282
{
283
"code": 0,
284
"message": "0",
285
"ttl": 1,
286
"data": {}
287
}
288
```
289
290
</details>
@@ -4461,3 +4461,7 @@ curl 'https://api.bilibili.com/x/polymer/web-dynamic/v1/feed/space?host_mid=2095
4461
4461
```
4462
4462
4463
4463
</details>
4464
4465
## 设置置顶动态
4466
4467
参见 [置顶动态](action.md#置顶动态)