API 名称：ListTemplates
API 域名：open.volcengineapi.com
API 描述：获取当前账号下的信息模板列表以及列表中每个信息模板的详细信息。您可以指定一个或者多个条件对返回的域名列表进行过滤。
GET
节流限制：您每秒最多可以发送 50 个请求。
每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见请求鉴权。
在调用该 API 时，您在请求中必须包含公共参数。在这些公共参数中，以下两个查询参数的取值说明如下：
| 参数名称 | 数据类型 | 必选 | 参数说明 |
|---|---|---|---|
| Action | string | 是 | 表示 API 的名称。该参数的取值是 ListTemplates。 |
| Version | string | 是 | 表示 API 的版本。该参数的取值是 2022-12-12。 |
该 API 的请求参数的类型是请求正文参数。
| 参数名称 | 数据类型 | 必选 | 参数说明 | 示例 |
|---|---|---|---|---|
| registrant_zh | string | 否 | 指定一个关键字，获取域名所有者的中文名中包含该关键字的信息模板的列表。 | 萌 |
registration_type | string | 否 | 指定一个域名所有者的类型，获取该类型的信息模板的列表。该参数有以下取值：
|
|
| tag | string | 否 | 指定一个信息模板的 tag，获取符合条件的信息模板的列表。 | G0zM6RUUWLPysIuVPF7obA== |
status | string | 否 | 指定一个或者多个信息模板的状态，获取这些状态下的信息模板的列表。多个状态使用逗号（,）分隔。您可以指定的状态有以下这些：
|
|
page_number | int | 否 | 指定一个页码，获取属于该页码的那些信息模板的列表。 |
|
| page_size | int | 否 | 指定每页包含的结果数量。该参数的最大值是 50，默认值是 10。 | 5 |
以下列表仅显示了此 API 返回信息模板参数中的一部分。关于不在该列表中的那些信息模板参数的说明，参见 CreateTemplate。
| 参数名称 | 数据类型 | 参数说明 | 示例 |
|---|---|---|---|
| total | int | 表示符合查询条件的信息模板总数。 | 10 |
template_info_list | []template_info | 表示一个信息模板对象的数组。 | |
-- country_code | string | 表示模板的 |
|
-- created_at | int64 | 表示模板的创建时间。时间格式是 Unix 时间戳，精度是秒。 |
|
-- status | string | 表示模板的状态。该参数有以下取值：
|
|
-- status_notice | string | 表示如果该模板未通过实名认证，认证失败所对应的消息。
|
|
| -- tag | string | 表示模板的 tag。 | G0zM6RUUWLPysIuVPF7obA== |
| -- updated_at | int64 | 表示模板最近的修改时间。时间格式是 Unix 时间戳，精度是秒。 | 1679463962 |
GET https://open.volcengineapi.com?Version=2022-12-12&Action=ListTemplates&tag=G0zM6RUUWLPysIuVPF7obA==
{ "ResponseMetadata": { "RequestId": "2023052215350182B7EECE220B2EF3F405", "Action": "ListTemplates", "Version": "2022-12-12", "Service": "domain_openapi", "Region": "cn-north-1" }, "Result": { "template_info_list": [ { "status": "not_validation", "status_notice": "", "tag": "G0zM6RUUWLPysIuVPF7obA==", "registration_type": "P", "country_code": "CN", "post_code": "163000", "email": "aaa@example.com", "registrant_fn": "San", "registrant_ln": "Zhang", "address": "My Address", "city": "Shanghai", "state": "Shanghai", "registrant": "San Zhang", "registrant_fn_zh": "三", "registrant_ln_zh": "李", "address_zh": "我的地址", "city_zh": "上海", "state_zh": "上海", "registrant_zh": "张三", "tel_country_code": "86", "tel_area_code": "", "tel_number": "12345678963", "tel_extension": "", "id_type": "", "id_code": "", "created_at": 1684740543, "updated_at": 1684740543 } ], "total": 1 } }
如果响应正文包含 Error 字段，则表示 API 请求失败。关于更多错误码的信息，参见 错误码。