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 艺人本人资料中的全部相册素材，包含 media_id 和 status
album_media[].type string 素材类型：image 或 video
album_media[].url string 素材 URL
album_media[].cover_url string 视频封面 URL，仅视频素材返回
album_media[].duration integer 视频时长，单位秒，仅视频素材返回
album_media[].media_id string 服务端生成的稳定媒体标识，编辑提交已有项时必须回传
album_media[].status string pending、passed、rejected、failed 或 timeout，由服务端维护
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 当前艺人的展示粉丝数，始终等于调整后的 follow_count
subscription_count integer 当前艺人的展示订阅人数；真实值统计当前艺人未过期且 status=1 的去重订阅粉丝，指定艺人另按统一规则叠加展示增量
cumulative_income_amount string 当前艺人自己的累计有效收益，单位元，排除退款扣回和取消收入
profile_update object 最新资料修订状态；存在多条独立待审修订时优先返回最新待审记录
profile_update.status string pending_review、applied、partial_applied、rejected、failed、timeout 或 superseded
profile_update.revision_no string/null 资料修订单号；从未产生修订时为 null
profile_update.audit_no string/null 内容审核单号；无审核单时为 null
profile_update.pending_fields array 尚未生效的字段名；非审核中状态固定为空数组
profile_update.submitted_at string/null 修订提交时间，格式 YYYY-MM-DD HH:mm:ss
profile_update.deadline_at string/null 异步审核截止时间，提交后 180 秒
profile_update.media_counts object 当前相册和语音各状态数量

响应示例：

{
  "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": [
      {
        "media_id": "AM0123456789ABCDEF01234567",
        "type": "image",
        "url": "https://cdn.example.com/album/a.png",
        "status": "passed"
      },
      {
        "media_id": "AM89ABCDEF0123456701234567",
        "type": "video",
        "url": "https://cdn.example.com/album/v.mp4",
        "cover_url": "https://cdn.example.com/album/v-cover.png",
        "duration": 58,
        "status": "pending"
      }
    ],
    "intro_audio": {
      "media_id": "AA0123456789ABCDEF01234567",
      "url": "https://cdn.example.com/intro.m4a",
      "duration": 58,
      "status": "pending"
    },
    "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",
    "profile_update": {
      "status": "pending_review",
      "revision_no": "APR2000120260815100000A1B2C3D4",
      "audit_no": "APA2000120260815100000E5F6A7B8",
      "pending_fields": [
        "album_media",
        "intro_type",
        "intro_text",
        "intro_audio_url",
        "intro_audio_duration"
      ],
      "submitted_at": "2026-08-15 10:00:00",
      "deadline_at": "2026-08-15 10:03:00",
      "media_counts": {
        "pending": 2,
        "passed": 1,
        "rejected": 0,
        "failed": 0,
        "timeout": 0
      }
    }
  }
}

说明：follow_count、fans_count、subscription_count 和 cumulative_income_amount 的真实统计均只使用当前登录艺人自己的数据；指定艺人的关注和订阅在真实统计完成后叠加与偶像列表相同的展示增量，其中订阅的真实基础仍是当前有效订阅人数，fans_count 始终等于调整后的 follow_count。withdrawable_amount 是可提现余额，cumulative_income_amount 是累计有效艺人收入，两者不是同一口径。艺人本人资料接口返回全部相册和语音对象及其审核状态；粉丝端列表和详情只返回 passed 媒体，未通过语音的平铺字段保持为空。