From 4d20caed1eb9151b8f51dbeadbc9a403121873d2 Mon Sep 17 00:00:00 2001
From: SessionHu <102411014+SessionHu@users.noreply.github.com>
Date: Wed, 7 May 2025 13:56:21 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E7=BD=AE=E9=A1=B6=E5=8A=A8=E6=80=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

close #1270
---
 docs/dynamic/action.md | 59 ++++++++++++++++++++++++++++++++++++++++++
 docs/dynamic/space.md  |  4 +++
 2 files changed, 63 insertions(+)

diff --git a/docs/dynamic/action.md b/docs/dynamic/action.md
index 82d1dbe..24eb26b 100644
--- a/docs/dynamic/action.md
+++ b/docs/dynamic/action.md
@@ -229,3 +229,62 @@ curl 'https://api.vc.bilibili.com/dynamic_draft/v1/dynamic_draft/rm_draft' \
 ```
 
 </details>
+
+## 置顶动态
+
+> https://api.bilibili.com/x/dynamic/feed/space/set_top
+
+**请求方法: POST**
+
+认证方式: Cookie (SESSDATA)
+
+**URL 参数:**
+
+| 参数名 | 类型   | 内容   | 必要性 | 备注 |
+| ------ | ------ | ------ | ------ | ---- |
+| csrf   | string | CSRF Token (即 Cookie 中 bili_jct) | 必要 |  |
+
+**正文参数 (application/json):**
+
+根对象:
+
+| 参数名  | 类型   | 内容     | 必要性 | 备注 |
+| ------- | ------ | -------- | ------ | ---- |
+| dyn_str | string | 动态 id  | 必要   |      |
+
+**JSON回复:**
+
+根对象:
+
+| 字段 | 类型   | 内容 | 备注 |
+| ---- | ------ | ---- | ---- |
+| code | number | 返回值 | 0: 成功<br />-101: 账号未登录<br />-111: csrf 校验失败<br />4100001: 参数错误 |
+| message | string | 错误消息 | 成功时为 `0` |
+| ttl  | number | `1`  |      |
+| data | object | 空对象 |    |
+
+**示例:**
+
+
+置顶动态 `1063487284684259332`
+
+```shell
+curl -X POST 'https://api.bilibili.com/x/dynamic/feed/space/set_top' \
+  --url-query 'csrf=xxx' \
+  -b 'SESSDATA=xxxxx' \
+  -H 'content-type: application/json' \
+  --data-raw '{"dyn_str":"1063487284684259332"}'
+```
+<details>
+<summary>查看响应示例:</summary>
+
+```json
+{
+  "code": 0,
+  "message": "0",
+  "ttl": 1,
+  "data": {}
+}
+```
+
+</details>
diff --git a/docs/dynamic/space.md b/docs/dynamic/space.md
index b3800f4..74830f3 100644
--- a/docs/dynamic/space.md
+++ b/docs/dynamic/space.md
@@ -4461,3 +4461,7 @@ curl 'https://api.bilibili.com/x/polymer/web-dynamic/v1/feed/space?host_mid=2095
 ```
 
 </details>
+
+## 设置置顶动态
+
+参见 [置顶动态](action.md#置顶动态)