- VenusEye请求结构
一.公共请求参数
公共请求参数是指每个接口都需要使用到的请求参数。
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| signature | String | 是 | 签名的结果串，用于签名的认证机制 |
注意：公共参数需要通过Header发送过来
二.公共响应参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| status_code | String | 是 | 响应状态码，代表当前响应是否成功 |
status_code 对应表
| status_code | 说明 |
|---|---|
| 200 | 响应成功，有查询记录 |
| 403 | 无权限 |
| 404 | 查无记录 |
| 501 | 查询参数异常 |
threat_score 对应表
| threat_score | 说明 |
|---|---|
| 0 | 安全 |
| 1-30 | 低危 |
| 31-70 | 中危 |
| 71-100 | 高危 |
- VenusEyeAPI接口_基础版
1.查询IP信息
输入：https://api.venuseye.com.cn/basic/ip/{ip}
请求类型：POST
示例：POST https://api.venuseye.com.cn/basic/ip/148.253.238.130
输出：
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| status_code | Integer | 是 | 响应状态码，代表当前响应是否成功 |
| ip | String | 是 | ip地址 |
| active_time | Integer | 是 | 更新时间 |
| threat_score | Integer | 是 | 威胁等级，代表样本的确定程度，分值越高误报的概率越小 |
Example:
POST https://api.venuseye.com.cn/basic/ip/148.253.238.130
{
"status_code":200,
"ip": "148.253.238.130", //ip字符串
"active_time": 1506677777,
"threat_score":80
}2.查询域名信息
输入：https://api.venuseye.com.cn/basic/domain/{domain}
请求类型：POST
示例：POST https://api.venuseye.com.cn/basic/domain/baidu.com
输出：
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| status_code | Integer | 是 | 响应状态码，代表当前响应是否成功 |
| domain | String | 是 | 域名 |
| active_time | Integer | 是 | 更新时间 |
| threat_score | Integer | 是 | 威胁等级，代表样本的确定程度，分值越高误报的概率越小 |
注意：参数{domain}请使用 URLEncode进行转码
Example:
POST https://api.venuseye.com.cn/basic/domain/baidu.com
{
"status_code":200,
"domain":"baidu.com",
"active_time": 1506677777,
"threat_score":80
}3.查询url信息
输入：https://api.venuseye.com.cn/basic/url/{url_sha256}
请求类型：POST
示例：POST https://api.venuseye.com.cn/basic/url/a9f4e019b27518df3703eb3ce98dcd328896e45a5cdc9e381099e680ca29868f
输出：
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| status_code | Integer | 是 | 响应状态码，代表当前响应是否成功 |
| url | String | 是 | url |
| active_time | Integer | 是 | 更新时间 |
| threat_score | Integer | 是 | 威胁等级，代表样本的确定程度，分值越高误报的概率越小 |
注意：查询的URL请使用 sha256进行转码后再进行查询
Example:
POST https://api.venuseye.com.cn/basic/url/a9f4e019b27518df3703eb3ce98dcd328896e45a5cdc9e381099e680ca29868f
{
"status_code":200,
"url":"https://api.reddit.com/r/japan",
"active_time": 1506677777,
"threat_score":80
}4.查询样本信息
输入：https://api.venuseye.com.cn/basic/hash/{type}/{hash}
请求类型：POST
示例：POST https://api.venuseye.com.cn/basic/hash/sha256/a9f4e019b27518df3703eb3ce98dcd328896e45a5cdc9e381099e680ca29868f
type值：md5,sha1,sha256
输出：
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| status_code | Integer | 是 | 响应状态码，代表当前响应是否成功 |
| sha256 | String | 是 | 样本的唯一标识 |
| sha1 | String | 是 | 样本的唯一标识 |
| md5 | String | 是 | 样本的唯一标识 |
| active_time | Integer | 否 | 更新时间 |
| threat_score | Integer | 否 | 威胁等级，代表样本的确定程度，分值越高误报的概率越小 |
Example:
POST https://api.venuseye.com.cn/basic/hash/sha256/a9f4e019b27518df3703eb3ce98dcd328896e45a5cdc9e381099e680ca29868f
{
"status_code":200,
"sha256": "a9f4e019b27518df3703eb3ce98dcd328896e45a5cdc9e381099e680ca29868f",
"md5": "4a4874fa5217a8523bf4d1954efb26ef",
"sha1": "9358bea376a9733fa763518a09362c891a00a777",
"active_time": 1506677777,
"threat_score":80
}
