Table of Contents
15.2.2 获取艺人聊天资料【已开发，待登录态和订阅数据联调】
GET /tieup/api/v1/me/artists/{artist_id}/chat-profile
Authorization: Bearer <access_token>
路径参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
artist_id |
integer | 是 | 正常公开艺人 ID；不要求当前存在订阅关系 |
响应字段：
| 字段 | 类型 | 说明 |
|---|---|---|
artist_id |
integer | 艺人 ID |
artist_avatar |
string | 艺人头像，优先读取艺人档案头像并补齐资源域名 |
artist_nickname |
string | 艺人昵称，优先读取艺名，艺名为空时回退绑定用户昵称 |
artist_gender |
integer | 艺人绑定用户性别：0=未知，1=男，2=女 |
companion_days |
integer | 按上海时区累计有效订阅自然日；订阅当天立即计 1 天，生效中的订阅只计算至当前自然日，当前无历史有效订阅时为 0 |
remaining_count |
integer | 当前粉丝今日还可向该艺人发送的消息条数，最低为 0 |
max_chars |
integer | 粉丝单条文字消息最大字符数，按去除首尾空白后的 UTF-8 文本计算 |
chat_background_url |
string | 当前粉丝为该艺人设置的专属聊天背景；未设置时为空字符串 |
完整响应示例：
{
"code": 200,
"message": "成功",
"data": {
"artist_id": 20001,
"artist_avatar": "https://cdn.example.com/artist.png",
"artist_nickname": "示例艺人",
"artist_gender": 2,
"companion_days": 37,
"remaining_count": 2,
"max_chars": 30,
"chat_background_url": "https://cdn.example.com/chat/background.png"
}
}
累计陪伴规则：只统计状态 1=生效中、2=已过期且同时存在 started_at、expires_at 的订阅区间，状态 3=已取消 的区间不计入；统一按 Asia/Shanghai 自然日计算，started_at 所在日立即计为第 1 天，started_at 晚于当前时间的未来区间不计入。生效中区间计算到当前自然日；历史区间保持 [started_at, expires_at) 权益边界，恰好在某日 00:00:00 到期时不计到期日，晚于零点到期则计入该日。多个区间覆盖的自然日合并去重，断档不会清零但断档日期不计，同一自然日内多段订阅也只计 1 天。例如 2026-06-25 00:01 或 23:59 订阅，当天均为 1 天，进入 6月26日 为 2 天，进入 6月27日 为 3 天。
私信额度规则：按当前粉丝渠道读取后台基础配置 fan_to_artist_daily_limit 和 fan_to_artist_text_max_chars，默认分别为 3 和 30。remaining_count 等于每日上限减去当前粉丝今日向该艺人已占用额度的消息数，最低返回 0；按北京时间自然日和“当前粉丝 + 当前艺人”维度统计，计入发送中、发送成功及成功后撤回的消息，明确发送失败的消息不占额度。该字段是查询时快照，实际发送仍以发送接口事务内的并发校验结果为准。