CheckDomain - Vérifier la disponibilité des noms de domaine - Domain Names

Les noms de domaine doivent respecter les exigences définies dans la rubrique Validité du nom de domaine.

Remarque

Le débit de l'API CheckDomain est limité à 10 QPS par utilisateur et 100 QPS au total.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature et génère un exemple de code SDK pour cette opération.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CheckDomain	Nom de l'opération à effectuer. Définissez la valeur sur CheckDomain.
DomainName	String	Oui	test**.xin	Nom de domaine à vérifier.
FeeCommand	String	Non	create	Commande d'opération. Valeurs possibles : create : Acheter un nom de domaine. renew : Renouveler un nom de domaine. transfer : Transférer un nom de domaine vers Alibaba Cloud. restore : Racheter un nom de domaine.
FeeCurrency	String	Non	USD	Type de devise. Valeurs possibles : USD : Dollar américain
FeePeriod	Integer	Non	1	Durée de l'abonnement. Unité : Year. Valeurs possibles : de 1 à 10.
Lang	String	Non	en	Langue des messages d'erreur. Valeurs possibles : zh : Chinois en : Anglais Valeur par défaut : en.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Avail	String	1	Indique si le nom de domaine peut être enregistré. Valeurs possibles : 1 : Le nom de domaine peut être enregistré. 3 : Le nom de domaine peut faire l'objet d'une pré-inscription. 4 : La pré-inscription peut être supprimée. 0 : Le nom de domaine ne peut pas être enregistré. -1 : Nom de domaine anormal. -2 : Enregistrement suspendu. -3 : Sur liste noire.
DomainName	String	test**.xin	Nom de domaine interrogé.
DynamicCheck	Boolean	true	Indique si le prix du nom de domaine est fixé par le registre. Valeurs possibles : true : Fixé par le registre. false : Non fixé par le registre.
Premium	String	true	Indique si le nom de domaine est premium. Valeurs possibles : true : Nom de domaine premium. false : Nom de domaine non premium.
Price	Long	1286	Prix d'enregistrement du nom de domaine premium.
Reason	String	In use	Motif renvoyé par le registre pour un nom de domaine indisponible. Remarque Les motifs varient selon le registre.
RequestId	String	BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1	ID de la requête.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format 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>

Format 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
            }
        ]
    }
}

Codes d'erreur

Consultez le Centre d'erreurs API pour obtenir la liste des codes d'erreur.