查询指定域名下的全部子域名的请求量统计。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
DomainName | string | 是 | 域名名称。 | example.com |
DomainType | string | 否 | 域名类型,大小写不敏感。取值:
| PUBLIC |
Keyword | string | 否 | 关键字,与 SearchMode 配合使用。 | test |
SearchMode | string | 否 | 关键词的搜索模式。取值:
| LIKE |
Direction | string | 否 | 排序方向。取值:
| DESC |
Threshold | long | 否 | 解析量查询条件,可用于查询不同解析量类别的子域名列表及子域名解析量数据。 不传:查询解析量非 0 的数据 传小于 0 的值:查询所有数据 传 0:查询无解析量的数据 传大于 0 的值:查询解析量不超过该值的子域名 | -1 |
StartDate | string | 是 | 开始时间,格式 yyyy-MM-dd,如: 2023-03-01。 | 2023-03-29 |
EndDate | string | 否 | 结束时间,格式 yyyy-MM-dd,如:2023-03-13。 | 2023-03-29 |
PageNumber | integer | 否 | 当前页数,起始值为 1,默认为 1。 | 1 |
PageSize | integer | 否 | 分页查询时设置的每页行数,最大值 1000,最小值为 1。 | 10 |
Lang | string | 否 | lang,语言:zh、en、ja。 | zh |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "389DFFA3-77A5-4A9E-BF3D-147C6F98A5BA",
"PageSize": 10,
"PageNumber": 1,
"TotalPages": 1,
"TotalItems": 1,
"Statistics": [
{
"SubDomain": "test.example.com",
"DomainName": "test.example.com",
"Count": "330",
"DomainType": "PUBLIC"
}
]
}
错误码
HTTP status code | 错误码 | 错误信息 |
---|---|---|
400 | Statistics.TooManyResults | Your query has produced too many results. |
400 | Statistics.InvalidDomainName | Your query param DomainName is invalid. |
400 | Statistics.InvalidStartDate | Your query param StartDate is invalid. |
400 | Statistics.InvalidEndDate | Your query param EndDate is invalid. |
400 | Statistics.InvalidSearchMode | Your query param SearchMode is invalid. |
400 | Statistics.InvalidOrderDirection | Your query param OrderDirection is invalid. |
400 | Statistics.InvalidDomainType | Your query param DomainType is invalid. |
400 | Statistics.QuotaExceededTime | Your query time range exceeds 90 days. |
400 | Sys.ParamsError | Your query param is invalid. |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 | ||||||
---|---|---|---|---|---|---|---|---|
2023-11-23 | OpenAPI 错误码发生变更 | 看变更集 | ||||||
| ||||||||
2023-04-04 | OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更 | 看变更集 | ||||||
|