action.md

# 表情操作

- [添加表情包](#添加表情包)
- [移除表情包](#移除表情包)

---

## 添加表情包

> http://api.bilibili.com/x/emote/package/add

*请求方式：POST*

认证方式：Cookie（SESSDATA）

只能添加有会员权限或已购买的表情包

**正文参数（ application/x-www-form-urlencoded ）：**

| 参数名     | 类型 | 内容                     | 必要性 | 备注                             |
| ---------- | ---- | ------------------------ | ------ | -------------------------------- |
| package_id | num  | 表情包ID                 | 必要   |                                  |
| business   | str  | 使用场景                 | 必要   | reply：评论区<br />dynamic：动态 |
| csrf       | str  | CSRF Token（位于cookie） | 必要   |                                  |

**json回复：**

根对象：

| 字段    | 类型 | 内容     | 备注                                                         |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code    | num  | 返回值   | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-403：访问权限不足 |
| message | str  | 错误信息 | 默认为0                                                      |
| ttl     | num  | 1        |                                                              |

**示例：**

添加ID为`25`的表情包，使用场景为评论区

```shell
curl 'http://api.bilibili.com/x/emote/package/add' \
--data-urlencode 'package_id=25' \
--data-urlencode 'business=reply' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```

<details>
<summary>查看响应示例：</summary>

```json
{
    "code": 0,
    "message": "0",
    "ttl": 1
}
```

</details>

## 移除表情包

> http://api.bilibili.com/x/emote/package/remove

*请求方式：POST*

认证方式：Cookie（SESSDATA）

**正文参数（ application/x-www-form-urlencoded ）：**

| 参数名     | 类型 | 内容                     | 必要性 | 备注                             |
| ---------- | ---- | ------------------------ | ------ | -------------------------------- |
| package_id | num  | 表情包ID                 | 必要   |                                  |
| business   | str  | 使用场景                 | 必要   | reply：评论区<br />dynamic：动态 |
| csrf       | str  | CSRF Token（位于cookie） | 必要   |                                  |

**json回复：**

根对象：

| 字段    | 类型 | 内容     | 备注                                                         |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code    | num  | 返回值   | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-403：访问权限不足 |
| message | str  | 错误信息 | 默认为0                                                      |
| ttl     | num  | 1        |                                                              |

**示例：**

移除ID为`25`的表情包，使用场景为评论区

```shell
curl 'http://api.bilibili.com/x/emote/package/remove' \
--data-urlencode 'package_id=25' \
--data-urlencode 'business=reply' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```

<details>
<summary>查看响应示例：</summary>

```json
{
    "code": 0,
    "message": "0",
    "ttl": 1
}
```

</details>