# OTT页面领取黄金会员接口
# 简介
# 业务介绍
调查询待领取黄金接口，对有待领取权益的用户展示领取入口，用户点击领取入口进入TV上的领取黄金页面，引导用户扫码到iqiyi领取黄金页面领取黄金会员。
# 领取规则
首次购买后需手动领取爱奇艺黄金会员，并绑定爱奇艺账号，后续续费会将爱奇艺黄金会员权益会自动发放至绑定的爱奇艺账号中；绑定账号后不能修改，请务必绑定本人手机号（账号）使用； 如账号需换绑手机号，可在爱奇艺APP进行操作，操作路径：底部栏“我的”—设置—账号与安全—手机号—修改手机号；
# 接口定义
# 应用场景
用户购买奇异果会员后可领取/自动赠送等时长的黄金会员。领取/自动赠送后台开关可配置，对接合作方自动赠送逻辑完成后，切换开关即可完成自动赠送逻辑切换。
# 接口域名
| 环境 | 域名 |
|---|---|
| 生产 | openapi.vip.iqiyi.com |
| 测试 | test-openapi.vip.iqiyi.com |
# URL
/act/getGiftVip.action
# 请求方式
| 参数 | 说明 |
|---|---|
| Method | GET/POST |
| Content-Type | application/x-www-form-urlencoded |
# 请求参数
| 变量名 | 类型 | 必需 | 说明 | |
|---|---|---|---|---|
| token | String | 是 | 进入h5页面的url上会带token变量，h5将这个变量通过这个接口回传给后端 | |
| mobile | String | 是 | 用户填写的手机号 | |
| sms_code | String | 是 | 用户输入的短信验证码 |
# 返回参数
| 变量名 | 名称 | 数据类型 | 说明 |
|---|---|---|---|
| code | 状态编码 | String | A00000，成功 Q00301，参数错误 Q00304，账号转换失败 Q00307，没有可领取的黄金会员 Q00309，合作方产品不支持领取 Q00332，系统错误 Q00349，短信验证码错误 Q00350，二维码链接已过期 |
| data.gift_receive_time | 领取时长 | String | 领取时长以天为单位返回 例如：62天 |
| data.isNew | 是否新用户 | String | "true"为新用户 |
| msg | 结果信息 | String | 处理成功 |
# 返回示例
{
"code": "Q00301",
"msg": "参数错误_token不能为空"
}
# 返回码定义
| 返回码code | 描述 | 备注 |
|---|---|---|
| A00000 | 成功 | |
| Q00301 | 参数错误（如合作方编号为空，合作方用户为空等） | |
| Q00307 | 签名错误 | |
| Q00332 | 系统错误 | |
| Q00711 | 调用规则引擎失败 | |
| Q00712 | 合作方没有有效的营销策略 | |
| Q00713 | 合作方用户没有可用的优惠资格 | |
| Q00719 | 合作方不支持页面领取 |
# 在线测试
| 参数 | 值 |
|---|---|
| token | 自行设定 |
| mobile | 自行设定 |
| sms_code | 自行设定 |
点击此处进行接口调试