# 网吧账号创建接口
# 简介
# 业务介绍
TOB业务合作方批量创建网吧终端亚账号
# 接口定义
# 应用场景
合作方调用此接口为网吧微端账号批量创建终端账号，该接口只涉及终端账号的创建，不涉及权益的开通
# 接口域名
| 环境 | 域名 |
|---|---|
| 生产 | serv.vip.iqiyi.com |
# URL
/api/cybercafe/account/create
# 请求方式
| 参数 | 说明 |
|---|---|
| Method | POST |
| Content-Type | application/x-www-form-urlencoded |
# 请求参数
正式参数由爱奇艺商务提供，测试参数参见在线测试
| 变量名 | 名称 | 必填 | 说明 |
|---|---|---|---|
| mobile | 微端账号手机号 | 是 | 待创建终端账号的微端账号手机号，由手机号获取uid，如uid不存在，则自动注册 |
| displayIds | 展示id字符串 | 是 | 需要创建的账号的展示id，由合作方约定，单个id长度32个字符以内，不能重复，多个id用英文逗号隔开，一次拼接100以内 |
| deviceId | 微端设备id | 是 | 微端的设备id |
| ip | ip | 是 | 微端的ip |
| partnerNo | 合作方类型 | 是 | 对应Tob直充接口的合作方类型 |
| sign | 签名 | 是 | 所有参数参与签名校验，String类型，MD5签名，签名方法见3.1 |
# 返回参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | String | 返回码，参考附录 |
| msg | String | 返回码说明 |
| data | Array | 构建成功的数据，如有重复的displayId，或disPlayId与已有重复，则创建失败，并返回该重复的dispalyId列表 |
# data参数
| 变量名 | 名称 | 是否必须 | |
|---|---|---|---|
| openid | 对外合作id | 是 | 终端账号的对外合作id，32位 |
| displayId | 展示id | 是 | 合作方传入的展示id |
# 请求示例
样例如下:
{
"code": "A00000",
"msg": "成功",
"data": [
{
"partnerUserId": "XXXXXXX" , #对外合作id。
"displayId": "XXXXXXXX", #展示id。
},
{
"partnerUserId": "XXXXXXX" , #对外合作id。
"displayId": "XXXXXXXX", #展示id。
}
]
}
{
"success": false,
"code": "Q02003",
"message": "账号重复",
"msg": "账号重复",
"data": [
"4mp8a7e0w3h2y1s9dqrv", # dispalyId
"4s8n1m7y3q5k0l6a2v9",
"8j3a9f0i7sb3f8d2n1z5",
"b1vlc7r5y8g6qz9k0u8x",
"g9f6r8l1b4c7q2y0n3w",
"j3k0y8p5a6q4v1b9z2l",
"n7ob4k1d9j6q3l5h8p2y",
"q1vz3w0k9u4l8n7f6b5",
"r0x6am4v8l2c9k5y1w7s",
"z8k5c6n3x2g1b4a7e0vi"
]
}
# 回码定义
| 返回码code | 描述 | 备注 |
|---|---|---|
| A00000 | 请求成功 | |
| Q00301 | 参数错误 | |
| Q00332 | 系统错误 | 建议重试或作为失败处理 |
| Q02001 | 没有剩余账号 | |
| Q02002 | 加密错误 | |
| Q02003 | 账号重复 | |
| Q02004 | 终端账号不存在 | |
| Q02005 | partnerNo不能为空 | |
| Q02006 | agentType不存在 | |
| Q02007 | 同一个微端账号不能对应多个agentType |
# 附录
# 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;
}
}
# RSA加密
import org.apache.commons.codec.binary.Base64;
import sun.misc.BASE64Decoder;
import sun.misc.BASE64Encoder;
import javax.crypto.Cipher;
import java.io.ByteArrayOutputStream;
import java.security.Key;
import java.security.KeyFactory;
import java.security.interfaces.RSAPublicKey;
import java.security.spec.PKCS8EncodedKeySpec;
import java.security.spec.X509EncodedKeySpec;
/**
* Description: 安全加密RSA.
*/
public class RsaUtil{
private static final int MAX_DECRYPT_BLOCK = 128;
/**
* 公钥加密过程
*
* @param publicKey 公钥 base64转码串
* @param plainTextData 明文数据
* @return 加密结果Base64转码串
* @throws Exception 加密过程中的异常信息
*/
public static String encryptForBase64(String publicKey, byte[] plainTextData)
throws Exception {
RSAPublicKey rsaPublicKey = getPublicKeyByStr(publicKey);
BASE64Encoder base64 = new BASE64Encoder();
return base64.encode(encrypt(rsaPublicKey, plainTextData));
}
/**
* 公钥加密过程
*
* @param publicKey
* @param plainTextData
* @return
* @throws Exception
*/
public static byte[] encrypt(RSAPublicKey publicKey, byte[] plainTextData)
throws Exception {
if (publicKey == null) {
System.out.println("加密公钥为空, 请设置");
throw new Exception();
}
Cipher cipher = null;
try {
// 使用默认RSA
cipher = Cipher.getInstance("RSA");
cipher.init(Cipher.ENCRYPT_MODE, publicKey);
byte[] output = cipher.doFinal(plainTextData);
return output;
} catch (Exception e) {
throw new Exception(e);
}
}
public static RSAPublicKey getPublicKeyByStr(String publicKeyStr)
throws Exception {
try {
BASE64Decoder Base64 = new BASE64Decoder();
byte[] buffer = Base64.decodeBuffer(publicKeyStr);
KeyFactory keyFactory = KeyFactory.getInstance("RSA");
X509EncodedKeySpec keySpec = new X509EncodedKeySpec(buffer);
return (RSAPublicKey) keyFactory.generatePublic(keySpec);
} catch (Exception e) {
e.printStackTrace();
throw new Exception(e);
}
}
}
# 常见问题
# 签名错误
请仔细阅读按签名规则和示例代码，需要注意：参数值为null的，key也会参与计算签名，所以最好传参就去掉值为null的key。MD5后的签名最后都转成小写
点击此处进行接口调试