【数据安全研究API服务】技术文档
说明:

重要声明:本平台提供的所有数据服务仅限用于合法的安全研究、数据加密技术验证、系统安全测试及授权范围内的合规业务场景。严禁将本服务用于任何非法用途,包括但不限于未经授权的数据获取、侵犯他人隐私等行为。用户在使用本服务前应确保其使用场景符合相关法律法规要求,如有违反,用户需自行承担全部法律责任。
服务特点:
- 毫秒级查询响应速度
- 支持Java、PHP、Go、Python等多种编程语言调用示例
- 完善的API文档和技术支持

使用流程:
1. 点击"API服务申请"按钮提交使用申请
2. 审核通过后获取专属接口地址和访问密钥
3. 按照技术文档集成到您的合规业务系统中
服务申请或技术咨询请联系客服

接口地址:审核通过后提供
功能描述:该接口可用于验证经过标准哈希处理的手机号格式数据,支持批量验证,每次请求1-100条数据
请求方式:POST
参数类型:application/json
请求参数:
请求参数 参数类型 描述 示例
key string 访问密钥(由平台审核通过后提供) cade57672df9a790ff1e2c686bba13ac
data array 经过标准哈希处理的数据数组(不超过100个) [c6851faaa918bc2a50053f3debe39476,7c8d879...]
t long 当前13位时间戳 1704038400000
sign string 安全签名(md5(key+t)) cade57672df9a790ff1e2c686bba13ac
请求示例
{
    "key": "cade57672df9a790ff1e2c686bba13ac",
    "data": ["6b0c76df26e9edd95dbf5afabfc5262f", "e69fca042a949510a67513fc2a2c6184", "18c15db0b007b60a6b8b868f7b4ec1a7"],
    "t": "1704038400000",
    "sign": "cade57672df9a790ff1e2c686bba13ac"
}
                                        
安全说明:
sign:安全签名 由key+t拼接后进行标准哈希处理
key:cade57672df9a790ff1e2c686bba13ac
t:1704038400000
string str = cade57672df9a790ff1e2c686bba13ac1704038400000
string sign = md5(str)
最终签名结果:7e11f0d182475f219cecb6965025a7e8
返回结果:
参数 参数类型 描述 示例
code int code码200成功 其它失败 200
msg string 返回描述 成功
data object 响应数据对象 code=200才返回 其它为null 《详情:下方data对象》 null
data对象:
参数 参数类型 描述 示例
success_list array 解密成功手机号对象《详情:下方success_list对象》 [5841322f0be754b04296977e03b793ca,58413......]
解密成功的AES手机号集合对象,需要通过AES解密出文明
AES密钥就是:客服提供的请求API密钥(key)的前16位
算法:AES
模式:ECB
填充:PKCS5Padding
数据块:128位
输出结果:Hex
输出编码:UTF-8
可以通过《AES加密解密工具》在线工具调试
AES解密出来就文明了[13000000000,13000000001]
error_list array 非法md5手机号集合 [e69fca042a949510a67513fc2a2c6184,18c15d...]
available_token int token可用次数 8000
success_list对象:
参数 参数类型 描述 示例
phone string AES加密-手机号 5841322f0be754b04296977e03b793ca
province string 省份 上海
city string 城市 上海
post_code string 邮编 200000
city_code string 区号 021
area_code string 行政区划 310100
isp string 运营商 中国移动
msg参数说明:
msg参数 描述
请求参数不合法 参数格式或值不符合要求,请检查key|data|t|sign参数
请求签名不正确 安全签名验证失败,请检查签名生成方式
请求接口请保持网络畅通 网络连接异常,请检查网络状态
返回示例
成功响应
{
    "code": 200,
    "msg": "操作成功",
    "data": {
        "success_list": [
            {
                "phone": "5841322f0be754b04296977e03b793ca",
                "province": "天津",
                "city": "天津",
                "post_code": "300000",
                "city_code": "022",
                "area_code": "120100",
                "isp": "中国移动"
            },
            {
                "phone": "5841322f0be754b04296977e03b793ca",
                "province": "天津",
                "city": "天津",
                "post_code": "300000",
                "city_code": "022",
                "area_code": "120100",
                "isp": "中国移动"
            },
            {
                "phone": "5841322f0be754b04296977e03b793ca",
                "province": "天津",
                "city": "天津",
                "post_code": "300000",
                "city_code": "022",
                "area_code": "120100",
                "isp": "中国移动"
            }
        ],
        "error_list": [],
        "available_token": 8000,
        "token_use": 500
    }
}
                                        
异常响应
{
    "code": 500,
    "msg": "无效访问密钥",
    "data": null
}
                                        

接口地址:审核通过后提供
功能描述:该接口可用于验证经过标准哈希处理的姓名格式数据,支持批量验证,每次请求1-100条数据
请求方式:POST
参数类型:application/json
请求参数:
请求参数 参数类型 描述 示例
key string 访问密钥(由平台审核通过后提供) cade57672df9a790ff1e2c686bba13ac
data array 经过标准哈希处理的数据数组(不超过100个) [c6851faaa918bc2a50053f3debe39476,7c8d879...]
t long 当前13位时间戳 1704038400000
sign string 安全签名(md5(key+t)) cade57672df9a790ff1e2c686bba13ac
请求示例
{
    "key": "cade57672df9a790ff1e2c686bba13ac",
    "data": ["6b0c76df26e9edd95dbf5afabfc5262f", "e69fca042a949510a67513fc2a2c6184", "18c15db0b007b60a6b8b868f7b4ec1a7"],
    "t": "1704038400000",
    "sign": "cade57672df9a790ff1e2c686bba13ac"
}
                                        
安全说明:
sign:安全签名 由key+t拼接后进行标准哈希处理
key:cade57672df9a790ff1e2c686bba13ac
t:1704038400000
string str = cade57672df9a790ff1e2c686bba13ac1704038400000
string sign = md5(str)
最终签名结果:7e11f0d182475f219cecb6965025a7e8
返回结果:
参数 参数类型 描述 示例
code int code码200成功 其它失败 200
msg string 返回描述 成功
data object 响应数据对象 code=200才返回 其它为null 《详情:下方data对象》 null
data对象:
参数 参数类型 描述 示例
success_list array 解密成功的姓名集合 [5841322f0be754b04296977e03b793ca]
解密成功的AES姓名集合对象,需要通过AES解密出文明
AES密钥就是:客服提供的请求API密钥(key)的前16位
算法:AES
模式:ECB
填充:PKCS5Padding
数据块:128位
输出结果:Hex
输出编码:UTF-8
可以通过《AES加密解密工具》在线工具调试
AES解密出来就文明了["张三"]
error_list array 无法解密的md5姓名集合 [e69fca042a949510a67513fc2a2c6184]
available_token int token可用次数 8000
msg参数提示说明:
msg参数 描述
请求参数不合法 参数不完整,检查下key|data|t|sign参数格式和值是否正确
请求签名不正确 签名不正确,检查签名是否与说明一致 由key+t 然后在md5加密
请求接口请保持网络畅通 请使用请求时的13位时间戳,保持请求一次获取一次
返回示例
成功
{
    "code": 200,
    "msg": "成功",
    "data": {
        "success_list": ["5841322f0be754b04296977e03b793ca"],
        "error_list": [],
        "available_token": 8000,
        "token_use": 500
    }
}
                                        
失败
{
    "code": 500,
    "msg": "无效key",
    "data": null
}
                                        

接口地址:审核通过后提供
功能描述:该接口可用于验证经过标准哈希处理的身份证号码格式数据,支持批量验证,每次请求1-100条数据
请求方式:POST
参数类型:application/json
请求参数:
请求参数 参数类型 描述 示例
key string 访问密钥(由平台审核通过后提供) cade57672df9a790ff1e2c686bba13ac
data array 经过标准哈希处理的数据数组(不超过100个) [c6851faaa918bc2a50053f3debe39476,7c8d879...]
t long 当前13位时间戳 1704038400000
sign string 安全签名(md5(key+t)) cade57672df9a790ff1e2c686bba13ac
请求示例
{
    "key": "cade57672df9a790ff1e2c686bba13ac",
    "data": ["6b0c76df26e9edd95dbf5afabfc5262f", "e69fca042a949510a67513fc2a2c6184", "18c15db0b007b60a6b8b868f7b4ec1a7"],
    "t": "1704038400000",
    "sign": "cade57672df9a790ff1e2c686bba13ac"
}
                                        
安全说明:
sign:安全签名 由key+t拼接后进行标准哈希处理
key:cade57672df9a790ff1e2c686bba13ac
t:1704038400000
string str = cade57672df9a790ff1e2c686bba13ac1704038400000
string sign = md5(str)
最终签名结果:7e11f0d182475f219cecb6965025a7e8
返回结果:
参数 参数类型 描述 示例
code int code码200成功 其它失败 200
msg string 返回描述 成功
data object 响应数据对象 code=200才返回 其它为null 《详情:下方data对象》 null
data对象:
参数 参数类型 描述 示例
success_list array 解密成功的身份证号码集合 [5841322f0be754b04296977e03b793ca]
解密成功的AES身份证号码集合对象,需要通过AES解密出文明
AES密钥就是:客服提供的请求API密钥(key)的前16位
算法:AES
模式:ECB
填充:PKCS5Padding
数据块:128位
输出结果:Hex
输出编码:UTF-8
可以通过《AES加密解密工具》在线工具调试
AES解密出来就文明了["11010119800101202x"]
error_list array 无法解密的md5身份证号码集合 [e69fca042a949510a67513fc2a2c6184]
available_token int token可用次数 8000
msg参数提示说明:
msg参数 描述
请求参数不合法 参数不完整,检查下key|data|t|sign参数格式和值是否正确
请求签名不正确 签名不正确,检查签名是否与说明一致 由key+t 然后在md5加密
请求接口请保持网络畅通 请使用请求时的13位时间戳,保持请求一次获取一次
返回示例
成功
{
    "code": 200,
    "msg": "成功",
    "data": {
        "success_list": ["5841322f0be754b04296977e03b793ca"],
        "error_list": [],
        "available_token": 8000,
        "token_use": 500
    }
}
                                        
失败
{
    "code": 500,
    "msg": "无效key",
    "data": null
}
                                        

接口地址:审核通过后提供
功能描述:该接口可用于查询当前访问密钥的剩余可用查询次数
请求方式:POST
参数类型:application/json
请求参数:
请求参数 参数类型 描述 示例
key string 访问密钥(由平台审核通过后提供) cade57672df9a790ff1e2c686bba13ac
t long 当前13位时间戳 1704038400000
sign string 安全签名(md5(key+t)) cade57672df9a790ff1e2c686bba13ac
安全说明:
sign:安全签名 由key+t拼接后进行标准哈希处理
key:cade57672df9a790ff1e2c686bba13ac
t:1704038400000
string str = cade57672df9a790ff1e2c686bba13ac1704038400000
string sign = md5(str)
最终签名结果:7e11f0d182475f219cecb6965025a7e8
返回结果:
参数 参数类型 描述 示例
code int 状态码 200表示成功 其它表示异常 200
msg string 返回信息描述 操作成功
data int 剩余可用查询次数 仅当code=200时返回 8000
msg参数 描述
请求参数不合法 参数格式或值不符合要求,请检查key|data|t|sign参数
请求签名不正确 安全签名验证失败,请检查签名生成方式
请求接口请保持网络畅通 网络连接异常,请检查网络状态
返回示例
成功响应
{
    "code": 200,
    "msg": "操作成功",
    "data": 8000
}
                                        
异常响应
{
    "code": 500,
    "msg": "无效访问密钥",
    "data": null
}
                                        
API服务申请
服务额度充值