购买校验接口

简介

业务介绍

爱奇艺有些产品会设置限购次数和用户限制，如新用户优惠，限购2次等，合作方可通过该接口查询当前用户是否可以购买爱奇艺产品

接口定义

应用场景

购买前查询是否有资格购买爱奇艺产品

接口域名

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

URL

/identification/check

请求方式

参数	说明
Method	GET/POST
Content-Type	application/x-www-form-urlencoded

请求参数

参数名	类型	必填	说明
partnerNo	String	是	合作方编码
item	String	是	产品编号（支持批量产品查询，按英文逗号分隔）
mobile	String	2选1	手机号，与partnerUserId选择一个传即可
partnerUserId	String	2选1	合作方用户id，与mobile选择一个传即可
amount	String	否	购买产品数量，默认为1
sign	String	否	md5签名，具体加密规则见MD5加密描述
platform	Number	否	平台值，默认0 0：其他 1：android(安卓端) 2：ios 3：PCW(PC网页) 4：H5 5：PCA 6：微信小程序 7：android tv 8：UWP

返回参数(单个产品查询)

字段名	类型	说明
code	String	响应码
msg	String	响应码说明
signPage	String	自动续费签约页面地址URL
maxAmount	Integer	最大可购买数量，产品为升级产品时返回

响应示例(单个产品查询)

{
    "code": "A00000",
    "msg": "处理成功",
    "data": 
        {
            "signPage": "www.xxx.com/xxx"
        }
}

{
    "code": "A00000",
    "msg": "处理成功",
    "data": 
        {
            "maxAmount": 105
        }
}

返回参数(多个产品查询)

字段名	类型	说明
code	String	响应码
msg	String	响应码说明
item	String	产品编号
checkResult	Object	检查结果
- code	String	检查结果响应码
- msg	String	检查结果响应码说明

响应示例(多个产品查询)

{
    "code":"A00000",
    "msg":"处理成功",
    "data":[
        {
            "item":"222",
            "checkResult":{
                "code":"A00000",
                "msg":"处理成功"
            }
        },
        {
            "item":"333",
            "checkResult":{
                "code":"Q00504",
                "msg":"产品库存不足"
            }
        },
        {
            "item":"444",
            "checkResult":{
                "code":"Q00505",
                "msg":"用户已到限购次数"
            }
        },
        {
            "item":"666",
            "checkResult":{
                "code":"A00000",
                "msg":"处理成功",
                "maxAmount": 102
            }
        }
    ]
}

返回码说明

响应码	说明	备注
A00000	用户身份校验通过
Q00301	参数错误，如encryptedMobile解密失败等
Q00611	调用passport获取用户信息失败，建议重试	建议重试
Q00502	账号被风控
Q00504	产品库存不足
Q00505	用户已到限购次数
Q00713	合作方用户没有可用的优惠资格，即身份校验没通过
Q00607	未签约自动续费
Q00608	请求自动续费接口错误，建议重试	建议重试

附录

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

JAVA版本示例代码如下：

public class Test{
/**
 * MD5签名测试类
 *
 */
    private static final char[] DIGITS = {'0', '1', '2', '3', '4', '5', '6',
        '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'};
    public static void main(String[] args) {
        TreeMap<String, Object> paramMap = new TreeMap<>();
        paramMap.put("a", "3");
        paramMap.put("b", "2");
        paramMap.put("c", "1");
        String md5key = "qwer";
        String targetParam = Joiner.on("&").withKeyValueSeparator("=")
        .useForNull("").join(paramMap);
        // MD5签名工具类,可以自己实现, MD5实现参照
        String targetSign = EncodeUtils.MD5(targetParam + md5key, "UTF-8");
        System.out.println("targetSign: " + targetSign);
    }
}

加密工具类

MD5加密

import com.google.common.base.Joiner;
import org.apache.commons.lang.StringUtils;
import org.junit.Test;
import java.util.HashMap;
import java.util.Map;
import java.util.TreeMap;
import java.io.UnsupportedEncodingException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
public class EncodeUtils{

    public static String MD5(String text, String charset) {

        MessageDigest msgDigest = null;
        try {
            msgDigest = MessageDigest.getInstance("MD5");
        } catch (NoSuchAlgorithmException e) {
            throw new IllegalStateException("System doesn't support MD5 algorithm.");
        }
        try {
            msgDigest.update(text.getBytes(charset));    //注意改接口是按照指定编码形式签名
        } catch (UnsupportedEncodingException e) {
            throw new IllegalStateException("System doesn't support your  EncodingException.");
        }
        byte[] bytes = msgDigest.digest();
        String md5Str = new String(encodeHex(bytes));
        return md5Str;
    }

    public static char[] encodeHex(byte[] data) {

        int l = data.length;
        char[] out = new char[l << 1];
        // two characters form the hex value.
        for (int i = 0, j = 0; i < l; i++) {
            out[j++] = DIGITS[(0xF0 & data[i]) >>> 4];
            out[j++] = DIGITS[0x0F & data[i]];
        }
        return out;
    }
}

在线测试

参数	值	备注
partnerNo	toB_common_test
item	111 222 333 444 555	111-天卡会员（1天） 222-月卡会员（1月） 333-季卡会员 444-年卡会员 555-周卡会员（7天）

所需密钥：

参数	值
MD5密钥	b0ee3c7f62760330

点击此处进行接口调试

在线调试