描述
根据传入参数检查域名是否可以注册。域名合法性判断参见域名合法性。
请求参数
公共请求参数,详见公共参数。
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
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
}