概要

网址安全查询API接口，可以查询目标网址是否为恶意网址。使用网址安全查询API接口，客户可以通过HTTPS(GET或POST)请求进行查询，并从服务器获得返回的网址状态结果。

入门

初次使用的用户要想使用网址安全查询API接口，须先有一个密钥认证KEY，这样才能使用该接口。申请密钥认证KEY，可以在门户中直接选择产品进行申请，亦可按照网页显示联系电话沟通。

简单的例子

您可以使用GET或POST方法来进行查询。GET方法很简单，但您每次只可以查询一个网址是否为恶意。POST方法允许您单次最多查询3条网址是否为恶意。

GET方法

客户端的请求URL：

https://lookup.api.bsb.baidu.com/urlquery?url=URL&ver=VERSION&key=APIKEY&cid=CID

服务器端的响应代码：

200

 服务器端的返回内容：

{"result":[{"url":"baidu.com", "main":"1", "sub":"1"}]}

POST方法：

客户端的请求URL：

https://lookup.api.bsb.baidu.com /urlquery?ver=VERSION&key=APIKEY&cid=CID

 客户端的请求体（每行一条待查询的url）：

aaa.com
bbb.com
ccc.com

服务器端的响应代码：

200

 服务器端的返回结果：

{"result":[{"url":"aaa.com", "main":"1", "sub":"1"}, {"url":"bbb.com", "main":"1", "sub":"1"}]}

协议规范 

l  HTTPS的GET请求：

使用一个简单的HTTP GET请求来查询一个网址是否为恶意。

 请求的URL：

https://lookup.api.bsb.baidu.com/urlquery?url=URL&ver=VERSION&key=APIKEY&cid=CID

CGI参数：

“ver”为接口版本(如2.0)；

“key”为用户密钥认证KEY(申请获得)；

“cid”为标示客户端的唯一id，区分不同的客户端(长度不超过32个字节)；手机客户端为IMEI。

“url”为待查询的url(每次一个)。

 服务器端的返回内容：

{"result":[{"url":"URL", "main":"TYPE", "sub":" TYPE "}]}

n  响应包含在请求的200OK消息体中。

n  返回的内容为json格式的字符串。

n  其中main为主类型，sub为子类型。

n  range为作用域（1，站点级；2，链接级；3，域名级）。

l  HTTPS的POST请求：

POST方法允许您单次最多查询5条网址是否为恶意。

 请求的URL：

https://lookup.api.bsb.baidu.com/urlquery?ver=VERSION&key=APIKEY&cid=CID

CGI参数：

“ver”为接口版本(2.0)；

“key”为用户密钥认证KEY(申请获得)；

“cid”为标示客户端的唯一id，区分不同的客户端(长度不超过32个字节)。

 请求体（每行一条待查询的url）：

aaa.com
bbb.com
ccc.com

服务器端的返回结果：

{"result":[{"url":"URL", "main":"TYPE", "sub":" TYPE "},……]}

n  响应包含在请求的200OK消息体中。

n  返回的内容为json格式的字符串。

n  其中main为主类型，sub为子类型。

使用限制

POST方法允许您单次最多查询3条网址是否为恶意。

一个密钥认证KEY在每天只可以查询x个网址。

使用HTTP的加密查询

支持HTTP消息携带加密数据的查询方式。

百度外部用户需要使用POST方式进行加密查询，请求的URL：

http:// lookup.api.bsb.baidu.com/urlquery?ver=VERSION&key=APIKEY&encrypt=true&cid=CID

加密查询是在非加密的POST查询基础上对HTTP消息体进行了加密。加密算法是xxtea，密钥需要向网址安全中心申请获取。

说明：

1）POST请求的URL如下格式：

 lookup.api.bsb.baidu.com/urlquery?ver=VERSION&key=APIKEY&encrypt=true&cid=CID

2）POST请求体格式如下：

{"query":[{"url":" baidu.com"}, {"url":" qq.com "}]}，然后使用

3）返回消息体满足如下格式：

{"result":[{"url":"baidu.com", "main":"1", "sub":"1"}, {"url":"qq.com", "main":"1", "sub":"1"}]}，需要使用

响应码

 免费使用

戳此 >> 免费使用网址安全检测