您的位置: 主页 > 操作小贴士 >

云崭数据Api如何对接

2020-05-12 15:49

云崭数据Api如何对接

Api文档

公共参数

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

上一篇:查看统计
下一篇:手机空号如何检测