查询域名是否可注册
CheckDomain
描述：根据传入参数检查域名是否可以注册。域名合法性判断参见
域名合法性。
请求参数
公共请求参数，详见
公共参数。
| 名称 | 类型 | 是否必须 | 描述 |
| Action | String | 是 | 操作接口名，系统规定参数，取值：CheckDomain。 |
| DomainName | String | 是 | 域名名称。 |
返回参数
| 名称 | 类型 | 描述 |
| RequestId | String | 唯一请求识别码。 |
| Name | String | 所查询域名名称。 |
| Avail | Integer | 是否能够注册。可能值：0 不可注册，1 可注册，-1 异常。 |
| Reason | String | 不可注册的原因。 |
| FeeCurrency | String | 币种。 |
| FeePeriod | Integer | 年限。 |
| FeeFee | String | 原始价格。 |
| RmbFee | String | 人民币价格。 |
| FeeCommand | String | 域名操作类型。 |
请注意：其中 FeeCurrency、FeePeriod、FeeFee、RmbFee、FeeCommand 为白金词返回价格参考参数，普通域名不返回。普通域名价格请参考官网价格。
错误码
对于所有接口的通用性错误，请参考 错误代码表。
| 错误代码 | 描述 | HTTP 状态码 | 语义 |
| Failed | Query failed. | 400 | 查询失败 |
| QueryRegistryFailed | Query registry failed. | 400 | 查询注册局失败 |
| Busy | Server is busy, please try again later. | 400 | 系统忙 |
| InvaildParameter | The parameter is invaild. | 400 | 非法参数 |
| QueryTairFailed | Query tair failed. | 400 | 查询 tair 失败 |
| DomainSuffixUnsupported | The domain name with this suffix is unsupported. | 400 | 不支持该后缀域名查询 |
示例
请求示例
- [backcolor=transparent]http[backcolor=transparent]:[backcolor=transparent]//domain.aliyuncs.com/?Action=CheckDomain
- [backcolor=transparent]&[backcolor=transparent]DomainName[backcolor=transparent]=[backcolor=transparent]abc[backcolor=transparent].[backcolor=transparent]com
- [backcolor=transparent]&<公共请求参数>
返回示例
[backcolor=transparent]XML 示例
- [backcolor=transparent]<CheckDomain>
- [backcolor=transparent] [backcolor=transparent]<RequestId>[backcolor=transparent]BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1[backcolor=transparent]</RequestId>
- [backcolor=transparent] [backcolor=transparent]<Name>[backcolor=transparent]abc.com[backcolor=transparent]</Name>
- [backcolor=transparent] [backcolor=transparent]<Avail>[backcolor=transparent]0[backcolor=transparent]</Avail>
- [backcolor=transparent] [backcolor=transparent]<FeePeriod>[backcolor=transparent]0[backcolor=transparent]</FeePeriod>
- [backcolor=transparent]</CheckDomain>
[backcolor=transparent]JSON 示例
- [backcolor=transparent]{
- [backcolor=transparent] [backcolor=transparent]"Name"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"abc.com"[backcolor=transparent],
- [backcolor=transparent] [backcolor=transparent]"Avail"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]0[backcolor=transparent],
- [backcolor=transparent] [backcolor=transparent]"RequestId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1"[backcolor=transparent],
- [backcolor=transparent] [backcolor=transparent]"FeePeriod"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]0
- [backcolor=transparent]}
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
阿里云 AI 助理回答
您提到的CheckDomain操作是阿里云域名服务的一项功能，用于检查给定的域名是否可以注册。根据您的描述，这个API接口允许用户通过发送一个HTTP请求来查询某个域名的可注册状态，同时在可能的情况下，还会返回与该域名相关的注册费用信息（特别是对于一些特定的或“白金词”域名）。
请求示例
如您所示，一个典型的请求URL格式如下：
http://domain.aliyuncs.com/?Action=CheckDomain&DomainName=example.com
在这个例子中，Action=CheckDomain指定了要执行的操作，而DomainName=example.com是要检查的域名名称。
请求参数
- Action: 必须参数，固定值为
CheckDomain，表示查询域名可注册性。 - DomainName: 必须参数，待查询的域名全称，例如
example.com。
返回参数
- RequestId: 每个请求的唯一标识。
- Name: 查询的域名名称。
- Avail: 域名可注册状态，0表示不可注册，1表示可注册，-1表示查询异常。
- Reason: 如果域名不可注册，这里会提供原因。
- FeeCurrency, FeePeriod, FeeFee, RmbFee, FeeCommand: 这些字段在某些情况下（如查询到的是特殊或“白金词”域名）会返回价格相关信息，包括币种、年限、原始价格、人民币价格和域名操作类型。普通域名通常不返回这些价格信息。
错误码
您也提到了几个可能出现的错误码及其含义，这些帮助理解API调用失败的原因，比如查询失败、系统繁忙、非法参数等。
注意事项
- 确保遵循阿里云API调用的认证流程，通常需要AccessKey ID和AccessKey Secret进行签名。
- 了解并遵守域名命名规则，确保所查询的域名符合域名合法性要求。
- 对于价格信息，尤其是对于非“白金词”或普通域名，建议直接参考阿里云官网的最新域名注册价格。
如果您需要进一步的帮助，比如如何实际调用这个API、处理返回结果或者遇到具体错误时的解决办法，请随时告知。
有帮助
无帮助
AI 助理回答生成答案可能存在不准确，仅供参考
相关问答