获取网站端口扫描结果
功能介绍
获取网站端口扫描结果
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v3/{project_id}/webscan/results/ports
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
用户的project_id，获取方法请参见获取项目ID。 最小长度：32 最大长度：32 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
task_id |
是 |
String |
任务ID 最小长度：32 最大长度：50 |
offset |
否 |
Integer |
分页查询，偏移量，表示从此偏移量开始查询 最小值：0 最大值：10000 缺省值：0 |
limit |
否 |
Integer |
分页查询，每页显示的条目数量 最小值：1 最大值：10000 缺省值：5 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：1 最大长度：102400 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
total |
Integer |
端口总数 最小值：0 最大值：100000 |
data |
Array of PortItem objects |
端口信息列表 数组长度：0 - 100000 |
参数 |
参数类型 |
描述 |
|---|---|---|
port |
Integer |
端口号 最小值：0 最大值：65535 |
service |
String |
服务 最小长度：0 最大长度：1000 |
protocol |
String |
端口协议:
枚举值：
|
status |
String |
端口状态:
枚举值：
|
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码 最小长度：0 最大长度：50 |
error_msg |
String |
错误描述 最小长度：0 最大长度：256 |
状态码： 401
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码 最小长度：0 最大长度：50 |
error_msg |
String |
错误描述 最小长度：0 最大长度：256 |
状态码： 418
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码 最小长度：0 最大长度：50 |
error_msg |
String |
错误描述 最小长度：0 最大长度：256 |
请求示例
GET https://{endpoint}/v3/{project_id}/webscan/results/ports?task_id=017281b97c9845b08174895992ba179643028
响应示例
状态码： 200
OK
{
"total" : 1,
"data" : [ {
"port" : 22,
"service" : "Secure Shell (SSH), secure logins, file transfers (scp, sftp) and port forwarding",
"protocol" : "TCP",
"status" : "open"
} ]
}
状态码
状态码 |
描述 |
|---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
418 |
I'm a teapot |
错误码
请参见错误码。
