全部产品
Search
文档中心

域名check接口

更新时间: 2018-04-10

描述

根据传入参数检查域名是否可以注册。域名合法性判断参见域名合法性

请求参数

公共请求参数,详见公共参数

名称 类型 是否必须 描述
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 非法参数。

示例

请求示例

  1. http://domain-intl.aliyuncs.com/?Action=CheckDomain
  2. &DomainName=abc.com
  3. &<公共请求参数>

返回示例

  • XML示例
  1. <CheckDomain>
  2. <RequestId>BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1</RequestId>
  3. <DomainName>abc.com</DomainName>
  4. <Avail>0</Avail>
  5. <Premium>false</Premium>
  6. </CheckDomain>
  • JSON示例
  1. {
  2. "RequestId": "BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1",
  3. "DomainName": "abc.com",
  4. "Avail": 0,
  5. "Premium": false
  6. }