# 表情操作 | BAC Document
社区开源的第三方哔哩哔哩 API 文档

# 表情操作

## 添加表情包

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

请求方式：POST

认证方式：Cookie（SESSDATA）

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

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

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

json回复：

根对象：

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

示例：

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

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

查看响应示例：

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

## 移除表情包

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

请求方式：POST

认证方式：Cookie（SESSDATA）

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

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

json回复：

根对象：

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

示例：

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

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

查看响应示例：

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