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

请求参数

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

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:CheckDomain
DomainName String 域名名称。
FeeCommand String 操作命令,取值:create 新购;renew 续费;transfer 转移;restore 赎回。
FeeCurrency String 货币类型,取值:CNY 人民币;USD 美元。
FeePeriod String 购买周期,单位:年。

返回参数

名称 类型 描述
RequestId String 唯一请求识别码。
DomainName String 所查询域名名称。
Avail Integer 是否能够注册。可能值:1 可注册;2 暂停注册;0 不可注册;-1 通信超时;-2 不可注册;-3 黑名单。
Reason String 不可注册原因。
Premium Boolean 是否是溢价词。可能值:true 是;false 否。
Price Long 溢价词注册价格。
DynamicCheck Boolean 是否动态询价

错误码

对于所有接口的通用性错误,请参考 错误代码表

错误代码 描述 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.aliyuncs.com/
?Action=CheckDomain
&DomainName=abc.xin
&FeeCommand=create
&FeeCurrency=USD
&FeePeriod=1
&<公共请求参数>

返回示例

  • XML示例
    <CheckDomain>
        <RequestId>BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1</RequestId>
        <DomainName>abc.xin</DomainName>
        <Avail>1</Avail>
        <Premium>true</Premium>
        <Reason></Reason>
        <Price>1286</Price>
    </CheckDomain>
  • JSON 示例
    {
        "RequestId": "BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1",
        "DomainName": "abc.xin",
        "Avail": 0,
        "Premium": false,
        "Reason": "",
        "Price": 1286
    }