Table of Contents
15.2.1 设置艺人专属聊天背景【已开发,待登录态联调】
PUT /tieup/api/v1/me/artists/{artist_id}/chat-background
Authorization: Bearer <access_token>
Content-Type: application/json
路径参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
artist_id |
integer | 是 | 正常公开艺人 ID;不要求当前存在订阅关系 |
请求字段:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
background_url |
string/null | 是 | 聊天背景完整 URL 或相对路径,最长 500;传空字符串或 null 表示恢复默认背景 |
完整请求示例:
{
"background_url": "https://cdn.example.com/chat/background.png"
}
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
artist_id |
integer | 艺人 ID |
background_url |
string | 补齐当前资源域名后的背景地址;已清除时为空字符串 |
完整响应示例:
{
"code": 200,
"message": "成功",
"data": {
"artist_id": 20001,
"background_url": "https://cdn.example.com/chat/background.png"
}
}
说明:数据库只保存无域名路径,例如 /chat/background.png。同一粉丝和艺人只有一条配置,重复设置原子覆盖;重复清除按成功返回,不要求先查询配置是否存在。