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.
A API CheckDomain tem limite de 10 QPS por usuário e 100 QPS no total.
Depuraçã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:
|
|
FeeCurrency |
String |
Não |
USD |
Tipo de moeda. Valores válidos:
|
|
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:
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:
|
|
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:
|
|
Premium |
String |
true |
Indica se o nome de domínio é premium. Valores válidos:
|
|
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.