您是否正受到短信签名报备的困扰?互亿无线解决方案让您最快15分钟内恢复信息传递,马上 注册体验
所有文档
文档中心 > 语音服务 > 号码标记查询(平台版)

号码标记查询(平台版)


提交号码标记查询(平台版)

1、接口描述

请求支持 POST 和 GET 两种方法,字符编码为 utf-8。

2、请求地址

https://api.ihuyi.com/info_service/numbermarkplatform/Submit.json

3、请求头说明

参数名称 参数值描述 示例 类型 必填
Content-Type 内容类型,固定值 application/x-www-form-urlencoded string

4、请求参数说明

参数名称 参数值描述 示例 类型 必填
account APIID(用户中心【信息服务】-【号码标记查询(平台版)】-【产品总览】 查看) xxxxxxxx string
password 1、APIKEY(用户中心【信息服务】-【号码标记查询(平台版)】-【产品总览】 查看)
2、动态密码(生成动态密码方式请看该文档末尾的说明)
xxxxxxxxx string
content 号码,支持手机号、电话号码、400号码、95/96号码;手机号为中国大陆地区11位数字,电话号码为区号+号码。
程序不校验号码的正确性,请查询前请确保号码真实有效。号码标记查询服务按提交成功计费,提交失败自动退费。
136xxxxxxxx string
time Unix时间戳(10位整型数字,当使用动态密码方式时为必填) 1623643787 string

5、响应参数

参数名称 参数值描述 示例 类型 必返
code 返回值为2时,表示提交成功 2|1 int
msg 提交结果描述 查询成功|查询失败 string
msgid 当提交成功后,此字段为流水号,否则为0或空 16236437872836|0 string
data 标记内容 object
Baidu 百度的标记数据 object
Count 标记次数(仅360和电话邦的有效) 1 string
IsTag 是否有标记:1有标记 2无标记 1 string
TagName 标记名称 诈骗电话 string
Qihu360 360的标记数据 object
Count 标记次数(仅360和电话邦的有效) 1 string
IsTag 是否有标记:1有标记 2无标记 1 string
TagName 标记名称 诈骗电话 string
Sougou 搜狗的标记数据 object
Count 标记次数(仅360和电话邦的有效) 1 string
IsTag 是否有标记:1有标记 2无标记 1 string
TagName 标记名称 诈骗电话 string
Tdx 泰迪熊的标记数据 object
Count 标记次数(仅360和电话邦的有效) 1 string
IsTag 是否有标记:1有标记 2无标记 1 string
TagName 标记名称 诈骗电话 string
Dianhuabang 电话邦的标记数据 object
Count 标记次数(仅360和电话邦的有效) 1 string
IsTag 是否有标记:1有标记 2无标记 1 string
TagName 标记名称 诈骗电话 string

6、响应状态码说明

code msg
0 未知错误
1 提交失败
2 提交成功
400 非法ip访问
401 帐号不能为空
402 密码不能为空
403 应用不存在
403 号码不能为空
4041 号码格式不正确,支持11位手机号码和带区号的固话电话号码
405 API ID 或 API KEY 不正确
4050 账号被冻结
40501 动态密码已过期
40502 动态密码校验失败
40505 没有签定合同
4051 剩余次数不足
4052 访问 ip 与备案 ip 不符
4086 通道无效
4010 通道错误

7、GET传参示例

https://api.ihuyi.com/info_service/numbermarkplatform/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&content=136xxxxxxxx&time=1623643787

8、响应示例

示例(成功)

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>查询成功</msg><msgid>16236437872836</msgid><data><Baidu><Count>1</Count><IsTag>1</IsTag><TagName>诈骗电话</TagName></Baidu><Qihu360><Count>1</Count><IsTag>1</IsTag><TagName>诈骗电话</TagName></Qihu360><Sougou><Count>1</Count><IsTag>1</IsTag><TagName>诈骗电话</TagName></Sougou><Tdx><Count>1</Count><IsTag>1</IsTag><TagName>诈骗电话</TagName></Tdx><Dianhuabang><Count>1</Count><IsTag>1</IsTag><TagName>诈骗电话</TagName></Dianhuabang></data></SubmitResult>
{    "code":
            2
        ,        "msg":
            "查询成功"
        ,        "msgid":
            "16236437872836"
        ,        "data":
                {    "Baidu":
                {    "Count":
            "1"
        ,        "IsTag":
            "1"
        ,        "TagName":
            "诈骗电话"
            }
            ,        "Qihu360":
                {    "Count":
            "1"
        ,        "IsTag":
            "1"
        ,        "TagName":
            "诈骗电话"
            }
            ,        "Sougou":
                {    "Count":
            "1"
        ,        "IsTag":
            "1"
        ,        "TagName":
            "诈骗电话"
            }
            ,        "Tdx":
                {    "Count":
            "1"
        ,        "IsTag":
            "1"
        ,        "TagName":
            "诈骗电话"
            }
            ,        "Dianhuabang":
                {    "Count":
            "1"
        ,        "IsTag":
            "1"
        ,        "TagName":
            "诈骗电话"
            }
                }
                }

示例(失败)

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>查询失败</msg></SubmitResult>
{"code":1,"msg":"查询失败"}

9、PHP生成动态密码方式代码示例

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$time = '1623643787';
$password=md5($account.$password.$time);
$password=md5('xxxxxxxxxxxxxxxxx1623643787');

//注意:所有字符编码统一为UTF-8

10、代码示例

5分钟快速自助开通免费体验账户

在线咨询
电话咨询

服务热线:

4008 808 898

服务热线(工作时间):

4008 808 898

业务咨询(非工作时间):

售后咨询(非工作时间):