擷取互連網開放服務。
介面說明
QPS 限制
本介面的單使用者 QPS 限制為 10 次/秒。超過限制,API 呼叫會被限流,這可能會影響您的業務,請合理調用。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| SourceIp |
string |
否 |
訪問者源 IP 位址。 |
122.200.64.XXX |
| Lang |
string |
否 |
語言類型。 枚舉值:
|
zh |
| Lang |
string |
否 |
語言類型。 枚舉值:
|
zh |
| ServiceName |
string |
否 |
應用程式名稱, 精確匹配, 不帶表示尋找所有應用。 |
SMB |
| ServiceNameFuzzy |
string |
否 |
應用程式名稱, 模糊比對, 不帶表示尋找所有應用。 |
SMB |
| RiskLevel |
string |
否 |
風險層級。 枚舉值:
|
2 |
| SuggestLevel |
string |
否 |
建議策略層級。 枚舉值:
|
10 |
| Port |
string |
否 |
連接埠號碼。 |
3389 |
| StartTime |
string |
否 |
查詢開始時間。使用秒級時間戳記格式表示。 |
1755742107 |
| EndTime |
string |
否 |
查詢結束時間。使用秒級時間戳記格式表示。 |
1753804800 |
| CurrentPage |
string |
否 |
頁碼。 |
1 |
| PageSize |
string |
否 |
頁數。 |
10 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
99A65AA0-C5B5-5092-BFCF-8111B436**** |
| PageInfo |
object |
分頁資訊。 |
|
| CurrentPage |
integer |
頁碼。 |
1 |
| PageSize |
integer |
分數。 |
20 |
| TotalCount |
integer |
總條數。 |
10 |
| DataList |
array<object> |
資料列表。 |
|
|
object |
資料列表。 |
||
| RiskLevel |
integer |
風險層級 -1:評估中 0:無 1: 低危 2: 中危 3: 高危. 不選代表所有風險 枚舉值:
|
3 |
| ProbRiskDesc |
string |
安全隱患描述。 |
test |
| TrafficPercent1Day |
string |
1 日流量佔比。 |
0 |
| Protocol |
string |
協議類型。 枚舉值:
|
tcp |
| PublicIpNum |
integer |
開放公網 IP 數量。 |
3 |
| SuggestLevel |
integer |
建議策略層級。 枚舉值:
|
20 |
| DetailNum |
integer |
明細數量。 |
5 |
| TrafficPercent7Day |
string |
7 日流量佔比。 |
77 |
| TrafficPercent30Day |
string |
30 日流量佔比。 |
0 |
| ProbRisk |
string |
安全隱患。 |
test |
| ServiceName |
integer |
應用程式名稱。 |
SMB |
| RiskReason |
string |
風險徵兆。 |
test |
| PortList |
array |
開放連接埠列表。 |
|
|
string |
開放連接埠列表。 |
[ 80, 8080, 80, 21 ] |
|
| InBytes |
integer |
流入流量。 |
447458.0 |
| OutBytes |
integer |
流出流量。 |
1123 |
| TotalBytes |
integer |
總流量。 |
621404 |
| UnknownReason |
array |
識別協議為 Unknown 情況下,未分析到協議的原因。 |
|
|
string |
識別協議為 Unknown 情況下,未分析到協議的原因。 |
no_payload |
樣本
正常返回樣本
JSON格式
{
"RequestId": "99A65AA0-C5B5-5092-BFCF-8111B436****",
"PageInfo": {
"CurrentPage": 1,
"PageSize": 20,
"TotalCount": 10
},
"DataList": [
{
"RiskLevel": 3,
"ProbRiskDesc": "test",
"TrafficPercent1Day": "0",
"Protocol": "tcp",
"PublicIpNum": 3,
"SuggestLevel": 20,
"DetailNum": 5,
"TrafficPercent7Day": "77",
"TrafficPercent30Day": " 0",
"ProbRisk": "test",
"ServiceName": 0,
"RiskReason": "test",
"PortList": [
"[\n 80,\n 8080,\n 80,\n 21\n]"
],
"InBytes": 447458,
"OutBytes": 1123,
"TotalBytes": 621404,
"UnknownReason": [
"no_payload"
]
}
]
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | ErrorDBSelectError | A database select error occurred. | 內部錯誤:資料庫查詢錯誤 |
| 400 | ErrorParameters | A parameter error occurred. | 參數錯誤 |
| 400 | ErrorMarshalJSON | internal error. | 內部錯誤。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。