1.应用范围

本文是创蓝闪验 SDK_服务端端接入文档，用于指导 开发者集成使用。在对接之前您需要花 5-10 分钟阅读以下条目，可减少对接过程中的问题。

• 常见问题请移步至「对接问题」

2.接口概要

接口使用https传输协议，POST方法，请求参数放到RequestBody中以application/x-www-form-urlencoded提交，非JSON格式，响应内容则为JSON格式。本文档包含置换手机号接口和本机号校验接口说明。
接口并发，三网运营商卡有不同的限制，详情如下：
移动：单个APP默认限制1000QPS，如需扩容需要工作日提前报备
联通：单个APP默认200QPS，如需扩容需要工作日提前报备
电信：支持5000QPS，如需扩容需要工作日提前报备

3.安全方式

接口使用https传输协议，且创蓝闪验服务端使用HmacSHA256加密算法验证请求参数中的签名，确保传输过程内部不会被拦截篡改。返回参数中的手机号使用AES或RSA加密。另推荐本文档接口由APP服务端调用，不要在APP前端直接调用，这样可以在官网控制台配置IP白名单，只有在白名单的IP才是合法请求，提高安全性。

4.手机号解密算法

返回参数中的mobileName字段，需要使用解密算法解密，默认为AES算法，密文为16进制字符串，解密时需要做对应转换。如在控制台创建应用时如填写了RSA公钥，则只能使用RSA算法解密，推荐1024或2048位PKCS#8格式密钥对。如未填写则只能使用AES CBC算法，以md5(appKey)前16位字符串为秘钥，后16位字符为初始化向量解密。解密方法详见demo代码中的解密工具类。

5.置换手机号接口—Android、iOS、HarmonyOS端

5.1接口地址和说明

5.2接口请求参数

5.3接口响应内容

响应body数据为JSON格式。

5.4接口返回示例

{
"code": "200000",
"chargeStatus": 1,
"message": "成功",
"data": {
    "tradeNo": "18112115031414011",
    "mobileName": "1F881288CC68352FC410E8D4A36FC6E0"
  }
}

6.置换手机号接口—H5端

6.1接口地址和说明

6.2接口请求参数

6.3接口响应内容

响应body数据为JSON格式。

6.4接口返回示例

{
    "code": "200000",
    "chargeStatus": 1,
    "message": "成功",
    "data": {
        "tradeNo": "18112115031414011",
        "mobile": "1F881288CC68352FC410E8D4A36FC6E0"
    }
}

7.置换手机号接口—微信小程序端

7.1接口地址和说明

7.2接口请求参数

7.3接口响应内容

响应body数据为JSON格式。

7.4接口返回示例

{
    "code": "200000",
    "chargeStatus": 1,
    "message": "成功",
    "data": {
        "tradeNo": "18112115031414011",
        "mobile": "1F881288CC68352FC410E8D4A36FC6E0"
    }
}

8.本机号码校验接口—Android、iOS、HarmonyOS端

8.1接口地址和协议说明

8.2接口请求参数

8.3接口响应内容

响应body数据为JSON格式。

8.4接口返回示例

{
"code": "200000",
"chargeStatus": 1,
"message": "成功",
"data": {
    "tradeNo": "18112115031414011",
    "isVerify":"1"
}
}

9.本机校验接口—H5端

9.1接口地址和说明

9.2接口请求参数

9.3接口响应内容

响应body数据为JSON格式。

9.4接口返回示例

{
    "code": "200000",
    "chargeStatus": 1,
    "message": "成功",
    "data": {
        "tradeNo": "18112115031414011",
        "isVerify": "1"
    }
}

10.附录

响应code码