公共参数
Authorization:用户身份令牌
通过header传递
值为sid:ts的Base64编码
1小时内有效,可本地缓存50分钟
sid |
注册自动生成,不同检测类型sid不同,联系客服获取 |
ts |
当前时间戳,格式为yyyyMMddHHmmss |
sig:验证参数
值为sid + skey + ts的SHA1加密串
与Authorization缓存策略相同
sid |
与Authorization的sid值相同 |
skey |
secret_key,安全密钥,与sid成对使用,联系客服获取 |
ts |
与Authorization的ts值相同 |
黑产检测
1.对称加密
请求方式 :POST
请求地址 :https://api.yunzhandata.com/api/darkindustry/v1.0/detect?sig=xxxx
请求 Header :
Authorization |
见公共参数说明 |
Content-Type |
application/json |
请求参数:
请求body:
{
"mobiles":[
"EE2118FFBA06E7FC02F4C5D2283954F2",
"A0C721007B6A9A027B739F9D04B8D589"
]
}
Body参数说明:
mobiles |
字符串数组,单个手机号使用AES对称加密,密钥为sid,不超过2000个 |
返回body:
{
"code": 0,
"message": "成功",
"requestId": "29a1fa16-fbc0-4234-b432-64e12a099e29",
"timestamp": "2019-08-27 12:18:26",
"mobiles": [
{
"mobile": "6A26A90ADDBF33F5118CC0299813DDB3",
"mobileStatus": 0,
"mobileStatusStr": "黑产"
},
{
"mobile": "A56B27E2BA4BBD64F42D0EE224BC1E20",
"mobileStatus": 0,
"mobileStatusStr": "黑产"
}
]
}
返回参数说明:
code |
返回码,非0即失败 |
message |
返回描述 |
timestamp |
时间戳 |
requestId |
请求id |
mobiles |
手机号信息,失败时为空 |
mobile |
检测的手机号,对称加密后的字符串 |
mobileSatus |
手机号状态,0-黑产,1-疑似,2-真实 |
mobileStatusStr |
手机号状态字符串 |
2.MD5加密
请求方式 :POST
请求地址 :https://api.yunzhandata.com/api/darkindustry/v1.0/detectMD5?sig=xxxx
请求 Header :
Authorization |
见公共参数说明 |
Content-Type |
application/json |
请求参数:
请求body:
{
"mobiles":[
"0cc0c3d5089e20f448145f2bdefd2cf3",
"cd8b85367ee1e06016656016d823ced4"
]
}
Body参数说明:
mobiles |
字符串数组,单个手机号使用MD5加密,不超过2000个 |
返回body:
{
"code": 0,
"message": "成功",
"requestId": "6573e7e0-b0dc-4da4-b971-8ad084d20d86",
"timestamp": "2019-09-28 11:56:11",
"mobiles": [
{
"mobile": "cd8b85367ee1e06016656016d823ced4",
"mobileStatus": 0,
"mobileStatusStr": "黑产"
},
{
"mobile": "0cc0c3d5089e20f448145f2bdefd2cf3",
"mobileStatus": 0,
"mobileStatusStr": "黑产"
}
]
}
返回参数说明:
code |
返回码,非0即失败 |
message |
返回描述 |
timestamp |
时间戳 |
requestId |
请求id |
mobiles |
手机号信息,失败时为空 |
mobile |
检测的手机号,md5字符串 |
mobileSatus |
手机号状态,0-黑产,1-疑似,2-真实 |
mobileStatusStr |
手机号状态字符串 |
空号检测
1.对称加密方式
请求方式 :POST
请求地址 :https://api.yunzhandata.com/api/ deadnumber/v1.0/detect?sig=xxxx
请求 Header :
Authorization |
见公共参数说明 |
Content-Type |
application/json |
请求参数:
请求body:
{
"mobiles":[
"EE2118FFBA06E7FC02F4C5D2283954F2",
"A0C721007B6A9A027B739F9D04B8D589"
]
}
Body参数说明:
mobiles |
字符串数组,单个手机号使用AES对称加密,密钥为sid,不超过2000个 |
返回body:
{
"code": 0,
"message": "成功",
"requestId": "29a1fa16-fbc0-4234-b432-64e12a099e29",
"timestamp": "2019-08-27 12:18:26",
"mobiles": [
{
"mobile": "6A26A90ADDBF33F5118CC0299813DDB3",
"mobileStatus": 0,
"mobileStatusStr": "空号"
},
{
"mobile": "A56B27E2BA4BBD64F42D0EE224BC1E20",
"mobileStatus": 0,
"mobileStatusStr": "空号"
}
]
}
返回参数说明:
code |
返回码,非0即失败 |
message |
返回描述 |
timestamp |
时间戳 |
requestId |
请求id |
mobiles |
手机号信息,失败时为空 |
mobile |
检测的手机号,对称加密后的字符串 |
mobileSatus |
手机号状态,0-空号,1-疑似,2-实号 |
mobileStatusStr |
手机号状态字符串 |
2.MD5加密方式
请求方式 :POST
请求地址 :https://api.yunzhandata.com/api/ deadnumber/v1.0/detectMD5?sig=xxxx
请求 Header :
Authorization |
见公共参数说明 |
Content-Type |
application/json |
请求参数:
请求body:
{
"mobiles":[
"81297b49adbd1b5adff82d303258203a",
"e9cd0ca81d7eac16183040d5742853fa"
]
}
Body参数说明:
mobiles |
字符串数组,单个手机号使用AES对称加密,密钥为sid,不超过2000个 |
返回body:
{
"code": 0,
"message": "成功",
"requestId": "29a1fa16-fbc0-4234-b432-64e12a099e29",
"timestamp": "2019-08-27 12:18:26",
"mobiles": [
{
"mobile": "81297b49adbd1b5adff82d303258203a ",
"mobileStatus": 0,
"mobileStatusStr": "空号"
},
{
"mobile": "e9cd0ca81d7eac16183040d5742853fa ",
"mobileStatus": 0,
"mobileStatusStr": "空号"
}
]
}
返回参数说明:
code |
返回码,非0即失败 |
message |
返回描述 |
timestamp |
时间戳 |
requestId |
请求id |
mobiles |
手机号信息,失败时为空 |
mobile |
检测的手机号,MD5加密后的字符串 |
mobileSatus |
手机号状态,0-空号,1-疑似,2-实号 |
mobileStatusStr |
手机号状态字符串 |
返回码说明:
0 |
成功 |
1000 |
参数非法 |
1001 |
Authorization参数错误 |
1002 |
签名过期 |
1003 |
缺少认证参数 |
1004 |
HTTP方法错误 |
1005 |
签名错误 |
1006 |
Content-Type参数错误 |
1008 |
Authorization格式错误 |
1009 |
Authorization时间过期 |
2001 |
secretid与验证类型不匹配 |
2002 |
账户剩余次数不足 |
2003 |
secretid无效 |
2004 |
资金账户无效 |
3000 |
手机号为空 |
3001 |
手机号超过2000 |
3002 |
手机号不正确 |
9000 |
系统错误 |
如果还是有问题,可以联系云崭数据客服,或者联系18621820973咨询API接口