获取互联网开放端口。
接口说明
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| SourceIp |
string |
否 |
访问源 IP 地址。 |
114.242.33.XXX |
| Lang |
string |
否 |
语言类型。 枚举值：
|
zh |
| Lang |
string |
否 |
语言类型。 枚举值：
|
zh |
| ServiceName |
string |
否 |
应用名称, 精确匹配, 不带表示查找所有应用。 |
SMB |
| ServiceNameFuzzy |
string |
否 |
应用名称, 模糊匹配, 不带表示查找所有应用。 |
SMB |
| RiskLevel |
string |
否 |
风险级别。 枚举值：
|
3 |
| SuggestLevel |
string |
否 |
建议策略级别。 枚举值：
|
10 |
| Port |
string |
否 |
端口号。 |
80 |
| StartTime |
string |
否 |
查询开始时间。使用秒级时间戳格式表示。 |
1735264800 |
| EndTime |
string |
否 |
查询结束时间。使用秒级时间戳格式表示。 |
1748358644 |
| CurrentPage |
string |
否 |
分页查询时的页码。 |
1 |
| PageSize |
string |
否 |
分页查询时的页数。 |
10 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
F3637663-991B-547F-9163-1A5AC367**** |
| PageInfo |
object |
页面信息。 |
|
| CurrentPage |
integer |
当前页码。 |
1 |
| PageSize |
integer |
当前页数。 |
10 |
| TotalCount |
integer |
数据的总条数。 |
39 |
| DataList |
array<object> |
返回数据列表。 |
|
|
object |
返回数据列表。 |
||
| RiskLevel |
integer |
风险级别。 枚举值：
|
3 |
| ProbRiskDesc |
string |
安全隐患描述信息。 |
desc |
| TrafficPercent1Day |
string |
流量占比。取值范围：1~100。 |
10 |
| Protocol |
string |
协议。 |
tcp |
| PublicIpNum |
integer |
开放公网 IP 数量。 |
10 |
| SuggestLevel |
integer |
建议策略级别。 枚举值：
|
20 |
| DetailNum |
integer |
明细数量。 |
5 |
| Port |
integer |
开放端口。 |
80 |
| TrafficPercent7Day |
string |
7 日流量占比。 |
30 |
| TrafficPercent30Day |
string |
30 日流量占比。 |
48 |
| ProbRisk |
string |
安全隐患。 |
test |
| RiskReason |
string |
风险描述。 |
test |
| ServiceNameList |
array |
应用列表。 |
|
|
string |
应用列表。 |
['HTTPS', 'RDP', 'SSL', 'Unknown'] |
|
| InBytes |
integer |
流入流量。 |
1456536639.0 |
| OutBytes |
integer |
流出流量。 |
117200.0 |
| TotalBytes |
integer |
总流量。单位：byte。 |
621404 |
| UnknownReason |
array |
识别协议为 Unknown 情况下，未分析到协议的原因。 |
|
|
string |
识别协议为 Unknown 情况下，未分析到协议的原因。 |
no_payload |
示例
正常返回示例
JSON格式
{
"RequestId": "F3637663-991B-547F-9163-1A5AC367****",
"PageInfo": {
"CurrentPage": 1,
"PageSize": 10,
"TotalCount": 39
},
"DataList": [
{
"RiskLevel": 3,
"ProbRiskDesc": "desc",
"TrafficPercent1Day": "10",
"Protocol": "tcp",
"PublicIpNum": 10,
"SuggestLevel": 20,
"DetailNum": 5,
"Port": 80,
"TrafficPercent7Day": "30",
"TrafficPercent30Day": "48",
"ProbRisk": "test",
"RiskReason": "test",
"ServiceNameList": [
"['HTTPS', 'RDP', 'SSL', 'Unknown']"
],
"InBytes": 1456536639,
"OutBytes": 117200,
"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. | 内部错误。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。