API 说明

API 名称：CheckFee

API 域名：domain-openapi.volcengineapi.com

API 描述：查询域名价格，能否注册以及是否包含限制词等信息。

请求方法

GET

使用限制

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

请求鉴权

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

公共参数

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

请求参数

该 API 的请求参数的类型是查询参数。

参数名称	数据类型	是否必选	参数说明	示例
domain	string	是	表示需要询价的一个二级域名。域名可以是中文域名，也可以是英文域名。域名需符合命名规则：仅可包含字母、数字和连字符（-），以点号（.）分隔各级标签，每个标签不超过 63 个字符；中文域名转换为 Punycode 后也需满足该长度限制。	test.com

返回参数

参数名称	数据类型	参数说明	示例
domain	string	表示询价的域名。	test.com
zone	string	表示该域名的顶级域。	.com
status	string	表示域名的注册状态。该参数有以下取值： 0：表示域名不可注册。 1：表示域名可注册。 2：表示询价超时。 3：表示不支持注册该后缀的域名。	1
is_limit_domain	bool	表示域名是否包含限制词。该参数有以下取值： true：表示包含限制词。 false：表示不包含限制词。如果该参数值是 true，域名仍然是可以注册的，但是可能无法通过命名审核。	true
new_price	string	表示域名第一年的注册费用。	56
renew_price	string	表示域名的续费价格。如果 status = 0，该参数值无效。	80
restore_price	string	表示域名的赎回价格。如果 status = 0，该参数值无效。	80
domain_type	string	表示域名的类型。该参数有以下取值： G：表示中文域名。 E：表示英文域名。	E
price_type	string	表示域名的价格类型。该参数有以下取值： 0：表示普通域名。 1：表示白金域名。 2：表示一口价域名。	0
notice_info	string	表示该接口返回的提示信息。例如请求超时，域名后缀不支持等。	暂不支持该后缀

请求示例

响应示例

错误码

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