通过对比权威数据源，对用户上传的姓名、身份证号和手机号进行验证，校验此三要素是否一致 ## 接口说明 - 支持携号转网，支持阿里宝卡、腾讯王卡等互联网公司与运营合作推出的手卡 - 只支持移动、电信、联通、广电号下发的手机主卡 - 不支持物联网卡、虚拟运营商卡（如阿里小号） ### 鉴权说明 易盾信息认证服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见[接口鉴权](https://support.dun.163.com/documents/391676076156063744?docId=622572798032863232) ## 请求 ### 请求地址 | 名称 | 值 | | --- | --- | | HTTP URL | [http://verify.dun.163.com/v1/mobile/check](http://verify.dun.163.com/v1/mobile/check) | | HTTP Method | POST | ### 请求头 | 名称 | 类型 | 必填 | 描述 | | --- | --- | --- | --- | | Content-Type | String | 是 | 固定值：“application/x-www-form-urlencoded” | ### 请求参数 请求参数由请求公共参数和请求业务参数两部分组成，通用参数见[请求通用字段](https://support.dun.163.com/documents/391676076156063744?docId=622573136165068800) | 名称 | 类 型 | 必填 | 是否支持加密 | 最大长度 | 描述 | | --- | --- | --- | --- | --- | --- | | name | String | 是 | 是 | 32 | 用户真实姓名，以身份证上姓名为准 | | cardNo | String | 是 | 是 | 18 | 用户身份证号码，目前支持一代/二代身份证，号码必须为18位或15位，末尾为x的需要大写为X | | phone | Number | 是 | 是 | 32 | 手机号，建议开发者增加手机号真实性校验来防刷 | | encryptType | String | 否 | 否 | 否 | 加密方式 “3”-SM4加密 “4”-AES加密（目前只支持SM4加密和AES加密，若添加了此字段，**则必须将可加密的字段全部加密，不可只对部分字段加密**） | ### 请求体示例 ``` name=张三&cardNo=341622123456784317&phone=13358123456&version=v1&businessId=xxx×tamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx ``` ## 响应 ### 响应结果 响应字段如下，响应通用字段已省略，详细见[响应公共字段](https://support.dun.163.com/documents/391676076156063744?docId=624032228347863040) | 名称 | 类型 | 必须返回 | 描述 | | --- | --- | --- | --- | | status | Number | 是 | 认证结果，1-通过 2-不通过 3-查无结果 0-待定 | | reasonType | Number | 否 | 原因详情： 2-认证不一致 3-该手机号查询无记录 4-认证信息有误 5-号码状态异常（空号、停机等） 6-解析手机号运营商失败 7-其他出错，请联系客服。 以下返回为**详版**专属（如需开通详版功能，请联系客服开通） 20-手机号已实名，姓名正确，但证件号错误 21-手机号已实名，证件号正确，但姓名错误 22-手机号已实名，但证件号和姓名均非该手机号绑定信息 100-交易次数超限或查询过于频繁，请稍后重试| | taskId | String | 是 | 本次请求数据标识，可以根据该标识查询数据最新结果 | | isPayed | Number | 是 | 本次请求是否收费标识，1代表收费，0代表不收费 | | mobileType | String | 是 | 运营商类型：1-移动，2-联通，3- 电信，4-广电，9,-未知 | | mnp | String | 否 | 是否携号转网：1-无携号转网，2-有携号转网，手机号三要素简版可返回，如需返回，请联系客服配置| | oriMobileType | String | 否 | 携号转网前运营商类型：1-移动，2-联通，3- 电信，4-广电，手机号三要素简版可返回，如需返回，请联系客服配置 | ### 响应体示例 ```json { "code": 200, "msg": "ok", "result": { "status": 1, "taskId": "xxxxxxxxxxxxxx", "reasonType": 1, "isPayed": 1, "mobileType": "1", "mnp": "1", "oriMobileType": "1" } } ``` ### 响应返回码 响应返回码见：[响应返回码](https://support.dun.163.com/documents/391676076156063744?docId=624032338595143680) ## 加密代码示例 ### AES加密代码示例 ```java import javax.crypto.Cipher; import javax.crypto.spec.SecretKeySpec; import java.nio.charset.StandardCharsets; import java.security.Key; public class AESUtils { /** * 加密 * * @param key 密钥 * @param data 待加密的明文 * @return * @throws Exception */ public static String encrypt(String key, String data) throws Exception { try { Cipher c = Cipher.getInstance("AES/ECB/PKCS5Padding"); Key aesKey = getAesKey(key.getBytes(StandardCharsets.UTF_8)); c.init(Cipher.ENCRYPT_MODE, aesKey); byte[] decValue = c.doFinal(data.getBytes(StandardCharsets.UTF_8)); return bytesToHex(decValue); } catch (Exception e) { throw new Exception("encrypt error!", e); } } public static String encrypt(String key, byte[] data) throws Exception { Cipher c = Cipher.getInstance("AES/ECB/PKCS5Padding"); Key aesKey = getAesKey(key.getBytes("UTF-8")); c.init(Cipher.ENCRYPT_MODE, aesKey); byte[] bytes = c.doFinal(data); return bytesToHex(bytes); } /** * 解密 * * @param key 密钥 * @param data 待解密的密文 * @return * @throws Exception */ public static byte[] decrypt(String key, String data) throws Exception { try { byte[] decryptData = hexToBytes(data); Cipher c = Cipher.getInstance("AES/ECB/PKCS5Padding"); Key aesKey = getAesKey(key.getBytes(StandardCharsets.UTF_8)); c.init(Cipher.DECRYPT_MODE, aesKey); return c.doFinal(decryptData); } catch (Exception e) { throw new Exception("decrypt error!", e); } } private static Key getAesKey(byte[] key) { return new SecretKeySpec(key, "AES"); } private static String bytesToHex(byte[] bArray) { StringBuilder sb = new StringBuilder(bArray.length); String sTemp; for (int i = 0; i < bArray.length; i++) { sTemp = Integer.toHexString(0xFF & bArray[i]); if (sTemp.length() < 2) { sb.append(0); } sb.append(sTemp.toUpperCase()); } return sb.toString(); } private static byte[] hexToBytes(String str) { if (str == null) { return null; } char[] hex = str.toCharArray(); int length = hex.length / 2; byte[] raw = new byte[length]; for (int i = 0; i < length; i++) { int high = Character.digit(hex[i * 2], 16); int low = Character.digit(hex[i * 2 + 1], 16); int value = (high << 4) | low; if (value > 127) { value -= 256; } raw[i] = (byte) value; } return raw; } public static void main(String[] args) throws Exception { String key = "12345678912345678912345678912345"; // 易盾分配的密钥 String data = "12345678912"; // 需要被加密的内容 String enStr = encrypt(key, data);//加密 System.out.println(enStr); } } ``` ### SM4加密代码示例 ```java import org.apache.commons.codec.binary.Hex; import org.bouncycastle.jce.provider.BouncyCastleProvider; import javax.crypto.Cipher; import javax.crypto.NoSuchPaddingException; import javax.crypto.spec.SecretKeySpec; import java.nio.charset.StandardCharsets; import java.security.*; import java.security.spec.KeySpec; import java.util.Base64; public class SM4Util { public static final String ALGORITHM_NAME = "SM4"; public static final String ALGORITHM_NAME_ECB_PADDING = "SM4/ECB/PKCS5Padding"; static { Security.addProvider(new BouncyCastleProvider()); } /** * 加密 * * @param data 需要加密的内容 * @param key 密钥 * @return */ public static String encrypt(String data, String key) { try { byte[] dataBytes = data.getBytes(StandardCharsets.UTF_8); Base64.Decoder decoder = Base64.getDecoder(); byte[] keyBytes = decoder.decode(key); SMS4KeySpec sms4KeySpec = new SMS4KeySpec(keyBytes); Cipher cipher = generateECBCipher(ALGORITHM_NAME_ECB_PADDING, Cipher.ENCRYPT_MODE, sms4KeySpec.getKey()); String encodeSource = Hex.encodeHexString(cipher.doFinal(dataBytes)); return encodeSource; } catch (Exception e) { e.printStackTrace(); return null; } } /** * 解密 * * @param encrypted 需要解密的内容 * @param key 密钥 * @return * @throws Exception */ public static String decrypt(String encrypted, String key) throws Exception { byte[] cipherText = Hex.decodeHex(encrypted.toCharArray()); Base64.Decoder decoder = Base64.getDecoder(); byte[] keyBytes = decoder.decode(key); SMS4KeySpec sms4KeySpec = new SMS4KeySpec(keyBytes); Cipher cipher = generateECBCipher(ALGORITHM_NAME_ECB_PADDING, Cipher.DECRYPT_MODE, sms4KeySpec.getKey()); return new String(cipher.doFinal(cipherText), StandardCharsets.UTF_8); } private static Cipher generateECBCipher(String algorithmName, int mode, byte[] key) throws InvalidKeyException, InvalidAlgorithmParameterException, NoSuchAlgorithmException, NoSuchProviderException, NoSuchPaddingException { Cipher cipher = Cipher.getInstance(algorithmName, BouncyCastleProvider.PROVIDER_NAME); Key sm4Key = new SecretKeySpec(key, ALGORITHM_NAME); cipher.init(mode, sm4Key); return cipher; } static class SMS4KeySpec implements KeySpec { private byte[] key; public SMS4KeySpec(byte[] key) throws InvalidKeyException { this(key, 0); } public SMS4KeySpec(byte[] key, int offset) throws InvalidKeyException { if (key.length - offset < 16) { throw new InvalidKeyException("Wrong key size"); } else { this.key = new byte[16]; System.arraycopy(key, offset, this.key, 0, 16); } } public byte[] getKey() { return (byte[]) ((byte[]) this.key.clone()); } } public static void main(String[] args) throws Exception { String key = "12345678912345678912345678912345"; // 易盾分配的密钥 String data = "12345678912"; // 需要被加密的内容 String enStr = encrypt(data, key);//加密 System.out.println(enStr); } } ```