8. 偶像端 API 8.5 获取偶像资料【基础探测通过，待数据联调】

Table of Contents

8.5 获取偶像资料【基础探测通过，待数据联调】

GET /tieup/api/v1/artist/profile

鉴权：需要 Authorization: Bearer <access_token>，且当前账号必须已开通偶像端。

说明：该接口返回当前登录账号对应的艺人档案资料。艺人头像来源为 tieup_artist.avatar，与用户身份头像 tieup_user.avatar 独立维护；创建艺人档案时默认同步一次用户头像，后续修改偶像资料不会反写用户头像。艺人性别不在 tieup_artist 重复存储，统一读取绑定用户的 tieup_user.gender。

响应字段：

字段 类型 说明
id integer 艺人 ID
user_id integer 绑定的 APP 用户 ID
rong_user_id string 艺人身份融云用户 ID，格式 tieup_artist_{artist_id}
artist_name string 艺人对外展示名称
avatar string 艺人头像 URL，来源 tieup_artist.avatar
album_media array 艺人相册素材，图片/视频列表
album_media[].type string 素材类型：image 或 video
album_media[].url string 素材 URL
album_media[].cover_url string 视频封面 URL，仅视频素材返回
album_media[].duration integer 视频时长，单位秒，仅视频素材返回
intro_type string 短介绍类型：text、audio 或空字符串
intro_text string 一句话文字介绍，intro_type=text 时使用
intro_audio_url string 一句话语音介绍 URL，intro_type=audio 时使用
intro_audio_duration integer 语音介绍时长，单位秒
gender integer 艺人性别，与绑定用户共用 tieup_user.gender：0=未知，1=男，2=女
artist_type integer 艺人类型：1=个人艺人，2=经纪公司艺人
artist_category_id integer/null 艺人分类 ID
personal_intro string 自我介绍
related_experience string 相关经历或代表作品，当前资料编辑接口不支持修改
phone string 联系手机号，当前资料编辑接口不支持修改
settled_at string/null 入驻时间
withdrawable_amount string 可提现金额
follow_count integer 当前艺人自己的粉丝数，统计 tieup_artist_follow.artist_id = 当前艺人ID AND status = 1
fans_count integer 当前艺人自己的粉丝数，兼容 UI 命名，值同 follow_count
subscription_count integer 当前艺人自己的有效订阅人数，统计当前艺人未过期且 status=1 的去重订阅粉丝
cumulative_income_amount string 当前艺人自己的累计有效收益，单位元，排除退款扣回和取消收入

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "id": 20001,
    "user_id": 10001,
    "rong_user_id": "tieup_artist_20001",
    "artist_name": "示例艺人",
    "avatar": "https://cdn.example.com/artist/avatar.png",
    "album_media": [
      {
        "type": "image",
        "url": "https://cdn.example.com/album/a.png"
      },
      {
        "type": "video",
        "url": "https://cdn.example.com/album/v.mp4",
        "cover_url": "https://cdn.example.com/album/v-cover.png",
        "duration": 58
      }
    ],
    "intro_type": "audio",
    "intro_text": "",
    "intro_audio_url": "https://cdn.example.com/intro.m4a",
    "intro_audio_duration": 58,
    "gender": 2,
    "artist_type": 1,
    "artist_category_id": 10,
    "personal_intro": "大家好，我是示例艺人。",
    "related_experience": "相关经历",
    "phone": "13800138000",
    "settled_at": "2026-06-22 10:00:00",
    "withdrawable_amount": "0.00",
    "follow_count": 15000,
    "fans_count": 15000,
    "subscription_count": 6820,
    "cumulative_income_amount": "16000.00"
  }
}

说明：follow_count、fans_count、subscription_count 和 cumulative_income_amount 均只统计当前登录艺人自己的数据；withdrawable_amount 是可提现余额，cumulative_income_amount 是累计有效艺人收入，两者不是同一口径。