获取互联网开放服务。
接口说明
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. | 内部错误。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。