空号检测
更新时间:2021-12-01
说明:根据号码返回当前号码状态,如错号、空号、实号等
请求结构
POST /haoma-cloud/openapi/phone-status/1.0
HOST pnvs.baidubce.com
Authorization: authorization string
请求头域
除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
---|---|---|---|---|
appkey | String | 是 | RequestBody 参数 | 主渠道信息。申请服务开通时颁发 |
subkey | String | 否 | RequestBody 参数 | 子渠道信息。字符串形式,长度范围为4~20,只能由数字、字母(区分大小写)组成信息。该字段为扩展字段,用于百度智能云console统计展示。本字段适用于代理商用户,请个人客户忽略。 |
phone | String | 是 | RequestBody 参数 | 注意:号码采用 sha1加密算法 |
返回头域
除公共头域,无其他特殊头域
返回参数
参数名称 | 类型 | 必选 | 说明 | |
---|---|---|---|---|
code | String | 是 | 服务返回业务码,具体返回如下: 10000-请求成功 10001-参数缺失 10002-参数无效 20001-内部错误 30001-访问ip不合法 |
|
msg | String | 否 | 错误信息,成功时为success。其他信息参考code业务码说明 | |
result | phone | String | 是 | 号码采用 sha1加密算法 |
phone_status | String | 是 | 号码状态,具体返回值如下: 4-空号 5-虚拟小号 6-错号 7-未知 8-实号 |
请求示例
POST haoma-cloud/openapi/phone-status/1.0 HTTP/1.1
HOST: pnvs.baidubce.com
Content-Type: application/json
Authorization: bce-auth-v1/2a05b5a19e494c5c9823d64ef5104ffb/2021-04-22T03:42:25Z/18000/x-bce-date;host/493a98de1efb44112fc9852863b6d1c883a12f3699ef7e90812fb833b4300cf4
{
"appkey": "appkey",
"phone": "f8544b96dfe56ea79e2914997572ec2386b28128"
}
返回示例
HTTP/1.1 200 OK
x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
Content-Type: application/json
{
"code":"10000",
"msg":"success",
"result":{
"phone":"f8544b96dfe56ea79e2914997572ec2386b28128",
"status":"8"
}
}