API接口检测

2020-06-01 10:19

公共参数

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

请求参数：

sig

见公共参数说明

请求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

请求参数：

sig

见公共参数说明

请求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

请求参数：

sig

见公共参数说明

请求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

请求参数：

sig

见公共参数说明

请求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接口