请求地址:/open/api/v1/retrieval/getHiddenDangerList
接口类型:HTTP
请求方法:POST
请求参数:
| 参数 | 是否必须 | 说明 |
|---|---|---|
| user | 是 | 第三方系统用户名 |
| timestamp | 是 | 请求发起时间戳 |
| sign | 是 | md5(timestamp+user+token) |
| startEndTime | 否 | 开始结束事件 |
| judgeState | 否 | 验证状态 传对应英文 未验证:judgeStateNone、 验证通过:judgeStateTrue、 误报:judgeStateFalse、 忽略:judgeStatePass |
| noticeState | 否 | 处置状态 传对应的英文 未通报noticeStateNone, 已通报noticeStateDone, 已完成noticeStateFinished |
| pageNo | 否 | 第几页 |
| pageSize | 否 | 每页大小 |
注意:pageSize不传时返回10000条
请求示例:
{“user”: “username”,“timestamp”: 1608616211,“sign”: xxxxxx“data”: {“startEndTime”: “2021-09-07 00:00:00”,“judgeState: “judgeStateNone”,“noticeState”: “noticeStateNone”,“pageNo”: 1,“pageSize”: 100}}
返回参数:
| 参数 | 说明 |
|---|---|
| errorCode | 错误码,当正确时返回null |
| errorMessage | 错误信息,当正确时返回null |
| data.pageNo | 当前第几页 |
| data.pageSize | 每页大小 |
| data.total | 总共条数 |
| data.totalPages | 总共页数 |
| data..result | 数组对象具体的对象数据 |
data.result对应字段:
| 字段名称 | 字段定义 | 字段类型 |
|---|---|---|
| 隐患ID | riskId | String |
| 漏洞名称 | issueName | String |
| 漏洞IP | issueIP | String |
| 漏洞端口 | issuePort | Int |
| 漏洞类型 | classify | List |
| 漏洞描述 | issueDescription | String |
| 漏洞解决方案 | issueSolution | String |
| 漏洞等级 | issueLevel | Int类型 0(信息),1(低危),2(中危),3(高危),4(紧急) |
| 漏洞关联单位 | unitName | String |
| IPv4地址 | assetIpv4 | String |
| IPv6地址 | assetIpv6 | String |
| 漏洞关联mac地址 | assetMac | String |
| 漏洞起始时间 | startTime | String |
| 漏洞结束时间 | endTime | String |
| 发现厂商 | discoverFactory | String |
| 漏洞来源 | eventFrom | String |
| 调用接口单位名称 | dataFrom | String |
| 验证状态 | judgeState | String |
| 处置状态 | noticeState | String |
| 原始事件 | rawEvent | String |
返回示例:
{"success": true,"errorCode": null,"errorMessage": null,"data": {"pageNo": 1,"pageSize": 1,"result": [{"riskId": "b9c69c42ce674ddd80578ed9306079e7","issueName": "隐患3344","issueIP": "www.baidu.com","issuePort": 0,"classify": [],"issueDescription": "","issueSolution": "","issueLevel": 4,"unitName": "浙江省公安厅","assetIpv4": null,"assetIpv6": null,"assetMac": null,"startTime": "2021-05-16 00:00:00","endTime": "2021-05-16 00:00:00","discoverFactory": "gonganbuSRC","eventFrom": "otherDiscover","dataFrom": "tianBao","judgeState": "judgeStateNone","noticeState": "noticeStateNone","rawEvent": "{\"classify\":[],\"issueName\":\"隐患3344\",\"rawEvent\":\"\",\"issueTestData\":\"\",\"pluginId\":\"\",\"libraryId\":0,\"issueHostName\":\"\",\"discoverFactory\":\"gonganbuSRC\",\"scannerTypeName\":\"\",\"issuePoc\":\"\",\"riskId\":\"b9c69c42ce674ddd80578ed9306079e7\",\"issueWeakAccont\":\"\",\"issueOriginalData\":\"\",\"issueWeakPassword\":\"\",\"judgeState\":\"judgeStateNone\",\"cve\":\"\",\"historyId\":0,\"assetId\":\"\",\"issueJudgmentBasis\":\"\",\"startTime\":\"2021-05-16 00:00:00\",\"issueLevel\":4,\"discoverDate\":\"2021-05-15 00:00:00\",\"timestamp\":\"1621143285539\",\"attachmentsLink\":\"{\\\"fileList\\\":[],\\\"imageList\\\":[]}\",\"cncve\":\"\",\"unitName\":\"浙江省公安厅\",\"fileAndImage\":{\"imageList\":[],\"fileList\":[]},\"dataFrom\":\"tianBao\",\"issueProtocol\":\"\",\"issueCheckItem\":\"\",\"scannerTypeId\":0,\"issueSolution\":\"\",\"issueServiceName\":\"\",\"issueUrl\":\"www.baidu.com\",\"issueIP\":\"www.baidu.com\",\"cnnvd\":\"\",\"cnvd\":\"\",\"issueApplicationName\":\"\",\"assetName\":\"www.baidu.com\",\"endTime\":\"2021-05-16 00:00:00\",\"issuePort\":0,\"bid\":\"\",\"cvss\":\"\",\"eventFrom\":\"otherDiscover\",\"noticeState\":\"noticeStateNone\",\"issueDescription\":\"\",\"taskId\":0,\"lastUpdateTime\":\"2021-05-16 00:00:00\"}"}],"total": 34064,"totalPages": 34064}}
