域名过户--域名服务-火山引擎

文档中心

导航

域名过户

最近更新时间：2024.06.26 13:18:24首次发布时间：2023.06.08 10:48:03

API 说明

API 名称：DomainRegistrantChange
API 域名：open.volcengineapi.com
API 描述：通过关联新的信息模板将一个域名过户。该 API 会创建一个异步任务。您可以使用 GetAsyncTask 跟踪过户的进展。

请求方法

POST

使用限制

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

请求鉴权

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

公共参数

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

参数名称	数据类型	必选	参数说明
Action	string	是	表示 API 的名称。该参数的取值是 `DomainRegistrantChange`。
Version	string	是	表示 API 的版本。该参数的取值是 `2022-12-12`。

请求参数

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

参数名称 数据类型 必选 参数说明 示例

domain string 是表示需要过户的一个域名。 example.com

参数名称	数据类型	必选	参数说明	示例
domain	string	是	表示需要过户的一个域名。	`example.com`
template_tag	string	是	表示需要关联的新信息模板的 tag。该信息模板必须是已通过实名认证的。您可以使用 GetTemplate 查看该信息模板的实名认证状态。如果该模板还未通过实名认证，您可以使用 ValidateTemplate 对该模板进行实名认证。	`S0zM6RUUWLPysIuVPF7ocB==`
is_transfer_limited_opened	bool	否	表示是否禁止该域名在过户后的 60 天内被转出到其他域名注册商。该参数有以下取值： `true`：表示在域名过户后的 60 天内禁止该域名被转出。 `false`：表示在域名过户后的 60 天内允许该域名被转出。该参数的默认值是 `false`。	`false`

template_tag

string

是

表示需要关联的新信息模板的 tag。该信息模板必须是已通过实名认证的。

您可以使用 GetTemplate 查看该信息模板的实名认证状态。如果该模板还未通过实名认证，您可以使用 ValidateTemplate 对该模板进行实名认证。

S0zM6RUUWLPysIuVPF7ocB==

is_transfer_limited_opened

bool

否

表示是否禁止该域名在过户后的 60 天内被转出到其他域名注册商。该参数有以下取值：

true：表示在域名过户后的 60 天内禁止该域名被转出。
false：表示在域名过户后的 60 天内允许该域名被转出。

该参数的默认值是 false。

false

示例

请求示例

POST https://open.volcengineapi.com?Version=2022-12-12&Action=DomainRegistrantChange
{
    "domain":"example.com",
    "template_tag":"G0zM6RUUWLPerIuVPF8ibA=="
}

响应示例

{
    "ResponseMetadata": {
        "RequestId": "20230522152902BF8AE46450333517309F",
        "Action": "DomainRegistrantChange",
        "Version": "2022-12-12",
        "Service": "domain_openapi",
        "Region": "cn-north-1"
    }
    "Result": {
        "task_no": "registrant-79aae6eab0db40521"
    }
}

错误码

如果响应正文包含 Error 字段，则表示 API 请求失败。关于更多错误码的信息，参见错误码。