You need to enable JavaScript to run this app.
导航
获取信息模板列表
最近更新时间:2023.09.27 19:03:14首次发布时间:2023.05.22 22:30:38

API 说明

API 名称:ListTemplates
API 域名:open.volcengineapi.com
API 描述:获取当前账号下的信息模板列表以及列表中每个信息模板的详细信息。您可以指定一个或者多个条件对返回的域名列表进行过滤。

请求方法

GET

使用限制

节流限制:您每秒最多可以发送 50 个请求。

请求鉴权

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见请求鉴权

公共参数

在调用该 API 时,您在请求中必须包含公共参数。在这些公共参数中,以下两个查询参数的取值说明如下:

参数名称数据类型必选参数说明
Actionstring表示 API 的名称。该参数的取值是 ListTemplates
Versionstring表示 API 的版本。该参数的取值是 2022-12-12

请求参数

该 API 的请求参数的类型是请求正文参数。

参数名称数据类型必选参数说明示例
registrant_zhstring指定一个关键字,获取域名所有者的中文名中包含该关键字的信息模板的列表。

registration_type

string

指定一个域名所有者的类型,获取该类型的信息模板的列表。该参数有以下取值:

  • C:表示类型是企业。

  • P:表示类型是个人。

C

tagstring指定一个信息模板的 tag,获取符合条件的信息模板的列表。G0zM6RUUWLPysIuVPF7obA==

status

string

指定一个或者多个信息模板的状态,获取这些状态下的信息模板的列表。多个状态使用逗号(,)分隔。您可以指定的状态有以下这些:

  • not_validation:表示模板还未启动实名认证流程。

  • pending_validation:表示模板正在实名认证的流程中。

  • verification_success:表示模板已实名认证。

  • verification_failed:表示模板未通过实名认证。

not_validation,verification_success

page_number

int

指定一个页码,获取属于该页码的那些信息模板的列表。
域名服务对查询结果进行分页展示。每页包含的结果数量是由 page_size 定义的。页数的计算公式是:total / page_sizetotal 表示结果总数,包含在该 API 的响应正文中。
该参数的默认值是 1

2

page_sizeint指定每页包含的结果数量。该参数的最大值是 50,默认值是 105

响应正文

以下列表仅显示了此 API 返回信息模板参数中的一部分。关于不在该列表中的那些信息模板参数的说明,参见 CreateTemplate

参数名称数据类型参数说明示例
totalint表示符合查询条件的信息模板总数。10

template_info_list

[]template_info

表示一个信息模板对象的数组。

-- country_code

string

表示模板的 city_zh 字段所对应的国家代码。当前,该字段的值是 CN

CN

-- created_at

int64

表示模板的创建时间。时间格式是 Unix 时间戳,精度是秒。

1674366362

-- status

string

表示模板的状态。该参数有以下取值:

  • not_validation:表示该模板还未启动实名认证流程。

  • pending_validation:表示该模板正在实名认证的流程中。

  • verification_success:表示该模板已实名认证。

  • verification_failed:表示该模板未通过实名认证。

verification_success

-- status_notice

string

表示如果该模板未通过实名认证,认证失败所对应的消息。

以下是几个消息示例:

  • 身份信息与证件不符

  • 模板审核失败

模板审核失败

-- tagstring表示模板的 tag。G0zM6RUUWLPysIuVPF7obA==
-- updated_atint64表示模板最近的修改时间。时间格式是 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 请求失败。关于更多错误码的信息,参见 错误码