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。同一粉丝和艺人只有一条配置,重复设置原子覆盖;重复清除按成功返回,不要求先查询配置是否存在。