号码标记查询接口文档 点击下载
号码标记查询接口接入指南 点击访问
1、概要
1.1 文档说明
本文档主要提供给互亿平台的用户对接接口的使用说明，开发者可以利用互亿无线提供的 HTTP 接口，调用互亿无线的号码标记查询服务，本接口支持查询vivo、oppo、小米、华为厂商标记及360手机助手、腾讯手机助手、百度平台的标记。
1.2 接口内容
本文档包含号码标记查询提交、余额查询。
1.3 提交方式
GET / POST
1.4 加密方式
1、采用HTTPS协议提交请求2、通过MD5动态签名方式加密
1.5 API ID / API KEY
登录用户中心，进入【信息服务-号码标记查询】模块，在【产品总览】页面右上角，如下图所示：
2、提交号码标记查询
2.1 接口描述
通过POST、 GET 方式进行提交，数据编码采用utf-8格式，支持24小时全天提交。
2.2 请求地址
https://api.ihuyi.com/info_service/numbermark/Submit.json
2.3 请求参数
参数名称
参数值描述
必填
account
APIID(用户中心【信息服务-号码标记查询】-【产品总览】查看)
是
password
1、APIKEY(用户中心【信息服务-号码标记查询】-【产品总览】查看)2、动态密码(生成动态密码方式请看该文档末尾的说明)
是
content
号码，支持手机号、电话号码、400号码、95/96号码；手机号为中国大陆地区11位数字，电话号码为区号+号码。程序不校验号码的正确性，请查询前请确保号码真实有效。号码标记查询服务按提交成功计费，提交失败自动退费。
是
time
Unix时间戳（10位整型数字，当使用动态密码方式时为必填）
否
用户通过http 或 https提交发送请求到服务器后，服务器会返回一串json格式的字符串，SubmitResult结构说明如下：
参数名称
类型
描述
code
int
返回值为2时，表示提交成功
msgid
string
当提交成功后，此字段为流水号，否则为0
msg
string
提交结果描述
data
object
标记内容
内容格式
参数名称
类型
描述
Baidu
object
百度的标记数据
Huawei
object
华为的标记数据
Oppo
object
OPPO的标记数据
Qihu360
object
360的标记数据
Tencent
object
腾讯的标记数据
Vivo
object
VIVO的标记数据
Xiaomi
object
小米的标记数据
标记数据格式
参数名称
类型
描述
Count
object
标记次数
ShowName
object
展示名称 如10086号码展示中国移动；可能为空
TagName
object
标记名称，如诈骗电话
2.4 响应示例
示例（成功）
{"code":2,"msg":"提交成功","msgid":"22101320041348318","data": {"Baidu":{"Count":"0","ShowName":"","TagName":""},"Huawei":{"Count":"0","ShowName":"","TagName":""},"Oppo":{"Count":"1","ShowName":"","TagName":""},"Qihu360":{"Count":"0","ShowName":"","TagName":""},"Tencent":{"Count":"5","ShowName":"","TagName":""},"Vivo":{"Count":"0","ShowName":"","TagName":""},"Xiaomi":{"Count":"0","ShowName":"","TagName":""}}}
示例（失败）
{"code":405,"msg":"API ID或API KEY不正确","msgid ":"0","data":{}}
2.5 响应参数
code
msg
0
未知错误
1
提交失败
2
提交成功
400
非法ip访问
401
帐号不能为空
402
密码不能为空
403
应用不存在
404
img_base64或img_url必须传一个
405
API ID 或 API KEY 不正确
4050
账号被冻结
40501
动态密码已过期
40502
动态密码校验失败
40505
没有签定合同
4051
剩余次数不足
4052
访问 ip 与备案 ip 不符
4086
图片错误
4010
通道错误
2.6 GET请求示例
https://api.ihuyi.com/info_service/number/Submit.json?account=APIID&password=APIKEY&content=136xxxxxxxx
3、号码标记服务余额查询
3.1 接口描述
通过接口可以方便的查询你的账户剩余次数。
3.2 请求地址
https://api.ihuyi.com/info_service/number/GetNum.json
3.3 请求参数
参数名称
参数值描述
是否必填
account
APIID（用户中心【信息服务-号码标记查询】-【产品总览】查看）
是
password
1、APIKEY（用户中心【信息服务-号码标记查询】-【产品总览】查看）2、动态密码（生成动态密码方式请看该文档末尾的说明）
是
time
Unix时间戳（10位整型数字，当使用动态密码方式时为必填）
否
用户通过http 或 https提交请求到服务器后，服务器会返回一串json格式的字符串，GetNumResult结构说明如下：
参数名称
类型
描述
code
int
状态返回值
msg
string
查询结果描述
num
string
剩余次数
3.4 响应示例
示例（成功）
{"code":2,"msg":"查询成功","num":123}
示例（失败）
{"code":405,"msg":"API ID或API KEY不正确","num":0}
3.5 响应参数
code
msg
2
查询成功
400
非法ip访问
401
帐号不能为空
402
密码不能为空
403
应用不存在
405
API ID或API KEY不正确
4050
账号被冻结
40501
动态密码已过期
40502
动态密码校验失败
4052
访问ip与备案ip不符
3.6 GET请求示例
https://api.ihuyi.com/info_service/number/GetNum.json?account=APIID&password=APIKEY
4、生成动态密码方式
以PHP为例，提交认证的生成方式：
$time = time();
$password=md5($account.$apikey.$time);
例如：
APIID： test
APIKEY：1q784322ba1******
time：1651544941
结果：$password=md5("test1q784322ba1******1651544941");
注意：所有字符编码统一为UTF-8
查询剩余条数的生成方式：
$time=time();
$password=md5($account.$apikey.$time);
例如：
APIID： test
APIKEY：1q784322ba1******
time：1651544941
结果：$password=md5("test1q784322ba1******1651544941");
Unix时间戳参考地址：http://tool.chinaz.com/Tools/unixtime.aspx
5、如何实现UNIX时间戳
语言
代码
JAVA
String date = new java.text.SimpleDateFormat("dd/MM/yyyy HH:mm:ss").format(new java.util.Date(Unix timestamp *1000))
Linux
date -d @Unix timestamp
C
strptime(datetime, "%Y-%m-%d %H:%M:%S", &tm_time); unixtime = mktime(&tm_time);
C++
std::time_t t = std::time(0);
DELPHI
uses DateUtils;DateTimeToUnix(Now)
GO
import "time"cur := time.Now()timestamp := cur.UnixNano() / 1000000
Perl
先 my $time = Unix timestamp 然后 my ($sec, $min, $hour, $day, $month, $year) = (localtime($time))[0,1,2,3,4,5,6]
PHP
date("r", Unix timestamp)
Node.js
var date = new Date( time * 1000 );var time = date.getTime()/1000;
Python
先 import time 然后 time.gmtime(Unix timestamp)
Ruby
Time.at(Unix timestamp)
SHELL
date +%s //UNIX 的时间戳;
VBScript / ASP
DateAdd("s", Unix timestamp, "01/01/1970 00:00:00")
VB6
DateDiff("s", "1970-1-1 0:0:0", ToUnixTime)
易语言
时间_到时间戳()
6、号码标记查询 DEMO示例
语言
代码
php
https://www.ihuyi.com/demo/numbermark/php.html
Java
https://www.ihuyi.com/demo/numbermark/java.html
C++
https://www.ihuyi.com/demo/numbermark/cpp.html
Go
https://www.ihuyi.com/demo/numbermark/go.html
python
https://www.ihuyi.com/demo/numbermark/python.html
7、号码标记查询接口产品开通
号码标记查询接口查询手机、固话号码标记信息 号码标记查询套餐 免费开通账户 号码标记查询介绍