Todos os produtos
Search
Central de documentação

Domain Names:CheckDomain

Última atualização: Jun 27, 2026

Verifica se um nome de domínio está disponível para registro.

Os nomes de domínio devem atender aos requisitos descritos em Validade de nome de domínio.

Nota

A API CheckDomain tem limite de 10 QPS por usuário e 100 QPS no total.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura e gera códigos de exemplo do SDK para esta operação.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

CheckDomain

Operação a executar. Defina como CheckDomain.

DomainName

String

Sim

test**.xin

Nome de domínio a verificar.

FeeCommand

String

Não

crie

Comando da operação. Valores válidos:

  • crie: Compra de nome de domínio.

  • renew: Renovação de nome de domínio.

  • transfer: Transferência de nome de domínio para a Alibaba Cloud.

  • restore: Resgate de domínio.

FeeCurrency

String

Não

USD

Tipo de moeda. Valores válidos:

  • USD: Dólar americano

FeePeriod

Integer

Não

1

Duração da assinatura. Unidade: Ano. Valores válidos: 1 a 10.

Lang

String

Não

en

Idioma da mensagem de erro. Valores válidos:

  • zh: Chinês

  • en: Inglês

Valor padrão: en.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

Avail

String

1

Indica se o nome de domínio permite registro. Valores válidos:

  • 1: Registro permitido.

  • 3: Pré-registro permitido.

  • 4: Exclusão de pré-registro permitida.

  • 0: Registro não permitido.

  • -1: Nome de domínio anormal.

  • -2: Registro suspenso.

  • -3: Incluído na lista de bloqueios.

DomainName

String

test**.xin

Nome de domínio consultado.

DynamicCheck

Boolean

true

Indica se o registro define o preço do nome de domínio. Valores válidos:

  • true: Definido pelo registro.

  • false: Não definido pelo registro.

Premium

String

true

Indica se o nome de domínio é premium. Valores válidos:

  • true: Domínio premium.

  • false: Domínio não premium.

Price

Long

1286

Preço de registro do domínio premium.

Reason

String

Em uso

Motivo retornado pelo registro para nome de domínio indisponível.

Nota

Os motivos variam conforme o registro.

RequestId

String

BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1

ID da solicitação.

Exemplos

Solicitações de exemplo

http(s)://domain.aliyuncs.com/? Action=CheckDomain
&DomainName=test**.xin
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

<CheckDomain>
      <RequestId>BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1</RequestId>
      <DomainName>test**.xin</DomainName>
      <Avail>1</Avail>
      <DynamicCheck>true</DynamicCheck>
      <Premium>false</Premium>
      <Reason></Reason>
      <Price>1286</Price>
      <StaticPriceInfo>
          <PriceInfo>
              <action>activate</action>
              <money>78</money>
              <period>12</period>
          </PriceInfo>
      </StaticPriceInfo>
</CheckDomain>

Formato JSON

{
    "RequestId": "BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1",
    "DomainName": "test**.xin",
    "Avail": "1",
    "DynamicCheck": true,
    "Premium": false,
    "Reason": "",
    "Price": 1286,
    "StaticPriceInfo": {
        "PriceInfo": [
            {
              "action": "activate",
              "money": 78,
              "period": 12
            }
        ]
    }
}

Códigos de erro

Consulte os códigos de erro na Central de Erros da API.