合作方券码激活前校验接口

简介

业务介绍

合作方券码激活前校验接口

接口定义

应用场景

由爱奇艺提供本接口供合作方调用，进行激活码校验

接口域名

环境	域名
生产	openapi.vip.iqiyi.com
测试	test-openapi.vip.iqiyi.com

URL

/rights-api/benifit/code/check

请求方式

参数	说明
Method	GET

请求参数

序号	变量名	名称	是否必须	类型	说明
1	customer	商户标识	是	String	合作方标识（爱奇艺侧分配）
2	code	券码	是	String	激活码
3	timestamp	时间戳	是	Long	时间戳(毫秒)
4	mobile	手机号	是	String
5	sign	接口签名	是	String	签名说明见下方附录

返回参数

字段名	类型	说明
code	String	返回码
msg	String	返回信息
data	Object	返回数据

返回码定义

返回码code	描述	备注
A00000	校验成功	券码可以激活
Q00301	参数错误	参数错误,缺少必填参数
Q00501	手机号未绑定爱奇艺账号
Q00502	券码不存在	券码不存在
Q00503	券码已过期	券码激活超过有效期，不能激活
Q00332	其他错误	调用失败，请重试

测试环境及参数

参数	值	备注
customer	benefit_test
签名秘钥	e85854766ad326f9

附录

MD5加密描述

采用MD5计算签名，MD5密钥由爱奇艺提供，具体计算方法如下：
1、 假设共有三个参数 a=3、b=2、c=1；
2、 按参数名的字母正序排列，再用“&”连接后得到串A，即为“a=3&b=2&c=1”；
3、 将MD5密钥拼接到串A后面，假设MD5密钥为“qwer”，则拼接后为“a=3&b=2&c=1qwer”；
4、 计算拼接串的MD5即为最终签名值，注意使用UTF-8编码计算,MD5后的签名最后都转成小写。
举例：
参数：a=3、b=2、c=1；
MD5密钥：qwer
最终签名串：f80118ff523f25eda67cb799bdc9c52d

常见问题

Q1.提示签名错误

1.联系爱奇艺对接人，确认配置的customer、秘钥是否和传入的一致
2.检查参数签名规则是否符合文档约束
3.若以上检查无问题，则提供下完整请求参数、签名前明文串