Table of Contents
8.1.1 H5 官网提交偶像入驻申请
POST /tieup/api/v1/h5/artist-applications
Content-Type: application/json
X-App-Channel: official
X-App-Platform: h5
请求体与 APP 入驻申请一致:
{
"applicant_name": "Tieup艺人工作室",
"name": "张三",
"phone": "13800138000",
"wechat_no": "tieup_artist",
"social_account": "抖音: tieup_artist",
"personal_intro": "个人介绍",
"related_experience": "相关经历",
"follower_count": 12,
"artist_type": 1
}
鉴权:不需要 Authorization,但必须传有效 X-App-Channel,且 X-App-Platform 必须为 h5。接口不需要短信验证码,不返回登录 Token,也不会返回万能验证码。
用户绑定规则:
- 服务端只按
X-App-Channel + phone查询用户;同一渠道下不区分应用、平台、市场、版本,一个手机号只能对应一个tieup_user。 - 用户不存在时创建最小用户资料,仅用于绑定本次申请,不自动完善昵称、头像、性别、出生日期等资料。
- 服务端随后查询该用户的入驻申请记录;存在
status=1待审核或status=2已通过时返回“请勿重复提交”。 - 只有无申请记录,或历史申请全部为
status=3已拒绝、status=4已取消时,才创建新的待审核申请。 - H5 创建的申请来源固定记录为
official_website,客户端不能传入或覆盖来源字段;申请平台快照固定为3=H5。 - 用户创建、申请状态检查和申请写入在同一事务内执行,并按渠道手机号、用户行锁和待审核唯一约束处理并发请求。
成功响应:
{
"code": 200,
"message": "成功",
"data": {
"id": 1,
"user_id": 10001,
"applicant_name": "Tieup艺人工作室",
"name": "张三",
"phone": "13800138000",
"wechat_no": "tieup_artist",
"social_account": "抖音: tieup_artist",
"personal_intro": "个人介绍",
"related_experience": "相关经历",
"follower_count": 12,
"artist_type": 1,
"submitted_at": "2026-08-18 10:00:00",
"status": 1,
"audit_remark": null
}
}
响应字段、状态值和字段校验与 POST /tieup/api/v1/artist-applications 完全一致;重复提交返回 422,消息为“请勿重复提交”。