You can call this operation to query the attack surface when a task instance scans an asset.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeAttackSurfacesFacets

The operation that you want to perform. Set the value to DescribeAttackSurfacesFacets.

TaskId Integer Yes 12345

The ID of the task that is queried.

Response parameters

Parameter Type Example Description
CrawlerRequests Integer 300

The number of crawler requests.

DNSMap Integer 10

The number of DNS records.

Domains Integer 10

The number of domain names.

Hosts Integer 10

The number of hosts.

Ports Integer 10

The number of ports.

RequestId String DD73CB0A-6E99-49AB-9569-5A00C9732795

The ID of the request.

Subdomains Integer 10

The number of subdomains.

WebPaths Integer 10

The number of web paths.

WebServers Integer 10

The number of web servers.

WebTechs Integer 10

The number of web applications.

Examples

Sample requests


http(s)://[Endpoint]/? Action=DescribeAttackSurfacesFacets
&<Common request parameters>

Sample success responses

XML format

<DescribeAttackSurfacesFacets>
	  <code>200</code>
	  <requestId>DD73CB0A-6E99-49AB-9569-5A00C9732795</requestId>
	  <success>true</success>
	  <data>
		    <Domains>10</Domains>
		    <Subdomains>20</Subdomains>
		    <DNSMap>20</DNSMap>
		    <Hosts>40</Hosts>
		    <Ports>30</Ports>
		    <WebTechs>40</WebTechs>
		    <WebServers>30</WebServers>
		    <WebPaths>20</WebPaths>
		    <CrawlerRequests>40</CrawlerRequests>
	  </data>
</DescribeAttackSurfacesFacets>

JSON format

{
	"requestId":"DD73CB0A-6E99-49AB-9569-5A00C9732795",
	"data":{
		"DNSMap":20,
		"CrawlerRequests":40,
		"WebPaths":20,
		"WebServers":30,
		"Subdomains":20,
		"WebTechs":40,
		"Hosts":40,
		"Domains":10,
		"Ports":30
	},
	"code":"200",
	"success":true
}

Error codes

For a list of error codes, visit the API Error Center.