CheckDomain - Domain Names - Centro de documentación de Alibaba Cloud

Comprueba si un nombre de dominio está disponible para registro.

Los nombres de dominio deben cumplir los requisitos indicados en Validez del nombre de dominio.

Nota

CheckDomain tiene un límite de 10 QPS por usuario y 100 QPS en total.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma y genera código de ejemplo del SDK para esta operación.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CheckDomain	Operación a ejecutar. Establezca este valor en CheckDomain.
DomainName	String	Sí	test**.xin	Nombre de dominio a comprobar.
FeeCommand	String	No	create	Comando de la operación. Valores válidos: create: Comprar un nombre de dominio. renew: Renovar un nombre de dominio. transfer: Transferir un nombre de dominio a Alibaba Cloud. restore: Rescatar un dominio.
FeeCurrency	String	No	USD	Tipo de moneda. Valores válidos: USD: Dólar estadounidense
FeePeriod	Integer	No	1	Duración de la suscripción. Unidad: Año. Valores válidos: de 1 a 10.
Lang	String	No	en	Idioma del mensaje de error. Valores válidos: zh: Chino en: Inglés Valor predeterminado: en.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Avail	String	1	Indica si el nombre de dominio se puede registrar. Valores válidos: 1: El nombre de dominio se puede registrar. 3: El nombre de dominio admite prerregistro. 4: Se puede eliminar el prerregistro. 0: El nombre de dominio no se puede registrar. -1: Nombre de dominio anómalo. -2: Registro suspendido. -3: En lista de bloqueados.
DomainName	String	test**.xin	Nombre de dominio consultado.
DynamicCheck	Boolean	true	Indica si el registro establece el precio del nombre de dominio. Valores válidos: true: Establecido por el registro. false: No establecido por el registro.
Premium	String	true	Indica si el nombre de dominio es premium. Valores válidos: true: Dominio premium. false: No es un dominio premium.
Price	Long	1286	Precio de registro del dominio premium.
Reason	String	En uso	Motivo devuelto por el registro para un nombre de dominio no disponible. Nota Los motivos varían según el registro.
RequestId	String	BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1	ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Consulte el Centro de errores de API para ver los códigos de error.