网址安全查询接口使用指南

2018-09-14 15:42:3438766人阅读

概要

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

入门

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

简单的例子

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

GET方法

客户端的请求URL

https://lookup.api.bsb.chjunkong.com/urlquery?url=url&ver=version&key=apikey&cid=cid

服务器端的响应代码:

200

 服务器端的返回内容:

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

POST方法:

客户端的请求URL

https://lookup.api.bsb.chjunkong.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  HTTPSGET请求:

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

 请求的URL

https://lookup.api.bsb.chjunkong.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  HTTPSPOST请求:

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

 请求的URL

https://lookup.api.bsb.chjunkong.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.chjunkong.com/urlquery?ver=version&key=apikey&encrypt=true&cid=cid

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

说明:

1POST请求的URL如下格式:

lookup.api.bsb.chjunkong.com/urlquery?ver=version&key=apikey&encrypt=true&cid=cid

2POST请求体格式如下:

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

3)返回消息体满足如下格式:

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


响应码

响应码


200

查询成功

401

认证失败

403

超过配额

5xx

内部错误

 免费使用

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

0
现金券
0
兑换券
立即领取
领取成功