描述
根据传入参数检查域名是否可以注册。域名合法性判断参见域名合法性。
请求参数
公共请求参数，详见公共参数。
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| Action | String | 是 | 操作接口名，系统规定参数，取值：CheckDomain。 |
| DomainName | String | 是 | 域名名称。 |
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| RequestId | String | 唯一请求识别码。 |
| DomainName | String | 所查询域名名称。 |
| Avail | Integer | 是否能够注册。 可能值： 1 可注册；0 不可注册；-1 异常。 |
| Premium | Boolean | 是否是溢价词。 可能值： true 是；false 否。 |
错误码
对于所有接口的通用性错误，请参考错误代码表。
| 错误代码 | 描述 | 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 | 非法参数。 |
示例
请求示例
http://domain-intl.aliyuncs.com/?Action=CheckDomain&DomainName=abc.com&<公共请求参数>
返回示例
XML示例
<CheckDomain><RequestId>BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1</RequestId><DomainName>abc.com</DomainName><Avail>0</Avail><Premium>false</Premium></CheckDomain>
JSON示例
{"RequestId": "BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1","DomainName": "abc.com","Avail": 0,"Premium": false}