所有文档

短信服务

语音服务

个人信息核验

运营商信息核验

银行信息核验

企业信息核验

车辆出行

应用开发

文字识别

数字权益

企业服务

基础知识

开发参考

文档中心 > 运营商信息核验 > 羊毛盾

羊毛盾

提交查询

1、接口描述

通过POST、 GET 方式进行提交，数据编码采用utf-8格式，支持24小时全天提交。

2、请求地址

https://api.ihuyi.com/idcard/abuseshield/Submit.json

3、请求头说明

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

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID(用户中心【认证核验】-【运营商信息验证】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【认证核验】-【运营商信息验证】-【产品总览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	xxxxxxxxx	string	是
mobile	检测手机号，限单个，仅支持11位国内号码	130********	string	是
mobile_ip	手机IP地址：重要参数；不传或将对检测结果产生影响，不能传入10,192,172等开头的内网IP地址	120.27.240.88	string	否
type	查询类型 1：MD5(32位小写)，0：普通手机号；默认0	0	string	否
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示提交成功	2\|1	int
msg	查询结果描述	提交成功\|提交失败	string
idcardid	当提交成功后，此字段为流水号，否则为0或空	16236437872836\|0	string
result	查询结果		object
info	信息详情		object
mobile	手机号，仅支持国内号码，11位	18236****10	string
status	检测结果，枚举值：W1：白名单 B1：黑名单 B2：可信用度低 N：库无	W1	string
score	检测分值，分值越高，风险越高。W1:[0-60); B2:[60-90); B1:[90-100]	35.0	string

6、响应状态码说明

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

7、GET传参示例

https://api.ihuyi.com/idcard/abuseshield/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&mobile=130********&mobile_ip=120.27.240.88&type=0&time=1623643787

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>提交成功</msg><idcardid>16236437872836</idcardid><result><info><mobile>18236****10</mobile><status>W1</status><score>35.0</score></info></result></SubmitResult>

{    "code":
            2
        ,        "msg":
            "提交成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "info":
                {    "mobile":
            "18236****10"
        ,        "status":
            "W1"
        ,        "score":
            "35.0"
            }
                }
                }

示例（失败）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>提交失败</msg></SubmitResult>

{"code":1,"msg":"提交失败"}

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

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'abuseshield'; //固定值
$mobile = '130********';
$time = '1623643787';
$password=md5($account.$password.$app.$mobile.$time);
$password=md5('xxxxxxxxxxxxxxxxxabuseshield130********1623643787');

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

羊毛盾

提交查询

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

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

10、代码示例

免费体验

填写验证码后，点击“开通体验账户”自动开通体验账户。