调用DescribeSubdomains查询任务实例对应攻击面数据项中的子域名信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeSubdomains

要执行的操作。取值:DescribeSubdomains

TaskId Integer 12345

任务ID。获取指定任务ID数据。

Asset String foo.com

资产名称。查询指定资产下的检测数据。

CurrentPage Integer 1

指定返回结果的当前页码。默认值为1。

PageSize Integer 10

指定列表每页显示数据条数。默认值为10,且可设置值最大为10。

返回数据

名称 类型 示例值 描述
Records Array

返回结果的记录列表。

Domain String www.foo.com

域名。

Index Integer 1

记录索引号。

RootDomain String foo.com

根域名。

UpdatedAt Long 1561392000000

扫描时间戳。

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

返回结果的请求ID。

Total Integer 1000

返回数据的总数量。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeSubdomains
&<公共请求参数>

正常返回示例

XML 格式

<DescribeSubdomainsResponse>
  <code>200</code>
	  <success>true</success>
	  <requestId>9D2C9710-A52C-4C4A-9082-9E570C958D5D</requestId>
	  <data>
		    <Total>120</Total>
		    <Records>
			      <Index>1</Index>
			      <Domain>www.foo.com</Domain>
			      <RootDomain>foo.com</RootDomain>
			      <UpdatedAt>1561392000000</UpdatedAt>
		    </Records>
		    <Records>
			      <Index>2</Index>
			      <Domain>www.bar.com</Domain>
			      <RootDomain>foo.com</RootDomain>
			      <UpdatedAt>1561392000000</UpdatedAt>
		    </Records>
	  </data>
</DescribeSubdomainsResponse>

JSON 格式

{
  "code": "200",
  "success": true,
  "requestId": "9D2C9710-A52C-4C4A-9082-9E570C958D5D",
  "data": {
  "Total": 120,
   "Records": [
     {
       "Index": 1,
       "Domain": "www.foo.com",       
       "RootDomain": "foo.com",       
       "UpdatedAt": 1561392000000
     },
     {
       "Index": 2,
       "Domain": "www.bar.com",       
       "RootDomain": "foo.com",       
       "UpdatedAt": 1561392000000
     }
   ]
  }
}

错误码

访问错误中心查看更多错误码。