WAPI – NSSET

Cet article traite des commandes WAPI propres au service WEDOS DNS (NSSET). Pour savoir comment configurer WAPI et résoudre les problèmes courants, consultez l’article WAPI – Manuel.

Ce guide traite des commandes WAPI pour NSSET, utilisé uniquement par les domaines CZ. Les instructions pour DNS se trouvent dans l’article WAPI – DNS.

Cet article présente les requêtes suivantes :

nsset-check

Utilisez la commande nsset-check pour vérifier si le nom du NSSET est libre pour l’enregistrement ou s’il se trouve dans un autre état.

Paramètres

  • tld – TLD du domaine
  • name – nom du NSSET

Valeurs de retour

  • 1000 = le NSSET est disponible pour l’enregistrement
  • 2201 = TLD invalide
  • 2247 = format de NSSET non pris en charge
  • 3242 = le NSSET est indisponible
  • 3245 = le NSSET est déjà enregistré
  • 3246 = indisponible
  • 3247 = indisponible
  • 3248 = indisponible – quarantaine
  • 3249 = indisponible – réservé
  • 3250 = indisponible – bloqué
  • 3251 = déjà enregistré (chez nous)
  • 4218 = échec de l’envoi – erreur de communication

Données de retour

La requête ne renvoie aucune donnée.

Modèles

Requête JSON :

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-check",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

Réponse JSON (OK) :

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-check"
  }
}

nsset-info

Utilisez la commande nsset-info pour télécharger les informations sur un NSSET.

Paramètres

  • tld – TLD
  • name – nom du NSSET

Valeurs de retour

  • 1000 = OK
  • 2201 = TLD invalide
  • 2209 = erreur de syntaxe
  • 2247 = format de NSSET non pris en charge 
  • 3214 = erreur – NSSET non chargé
  • 3242 = le NSSET est indisponible
  • 4204 = erreur de connexion, réessayez plus tard

Données de retour

En cas de succès, la requête renvoie un élément nsset dans le nœud data avec les entrées suivantes :

  • name – nom du NSSET
  • status – état
  • reg_owner – registrar actuel
  • reg_creator – créateur du NSSET (registrar)
  • reg_update – registrar ayant effectué la dernière modification
  • created_date – date de création
  • updated_date – date de la dernière modification
  • transfer_date – date du transfert vers un autre registrar
  • tech_c – contact technique du NSSET
  • dns – liste des serveurs DNS
  • server
    • name – nom du serveur
    • addr_ipv4 – adresse IPv4 du serveur
    • addr_ipv6 – adresse IPv6 du serveur

Modèles

Requête JSON :

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

Réponse JSON (OK) :

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-info",
    "data": {
      "nsset": {
        "name": "NSSET name",
        "status": "status",
        "reg_owner": "current registrar",
        "reg_creator": "NSSET creator (registrar)",
        "reg_update": "last update registrar",
        "created_date": "date and time of creation",
        "updated_date": "date and time of last update",
        "transfer_date": "date and time of last transfer",
        "tech_c": "technical contact ID",
        "dns": {
          "server1": {
            "name": "DNS server name",
            "addr_ipv4": "DNS server IPv4",
            "addr_ipv6": "DNS server IPv6"
          }
        }
      }
    }
  }
}

nsset-create

Utilisez la commande nsset-create pour créer un nouveau NSSET. Le NSSET contient une liste de serveurs NS ; chaque serveur comporte une entrée de nom et éventuellement son adresse IP. Vous pouvez aussi définir un contact technique – à défaut, le contact par défaut (WEDOS) sera utilisé.

Paramètres

  • tld – TLD
  • name – nom du NSSET
  • dns – liste des serveurs ns, chaque entrée contient les informations sur le serveur ns concerné
    • server
      • name – nom (adresse du domaine)
      • addr_ipv4 – adresse IPv4
      • addr_ipv6 – adresse IPv6
  • tech_c – contact technique – facultatif

Valeurs de retour

  • 1000 = OK, NSSET créé
  • 2201 = TLD saisi incorrect
  • 2210 = format des serveurs ns invalide
  • 2211 = trop de serveurs ns
  • 2216 = syntaxe du contact technique invalide 
  • 2247 = format de NSSET non pris en charge 
  • 3228 = la gestion des contacts n’est pas prise en charge
  • 3229 = erreur de chargement du contact
  • 3242 = le NSSET est indisponible
  • 3244 = échec de la création du NSSET
  • 3245 = le NSSET est déjà enregistré
  • 3246 = indisponible
  • 3247 = indisponible
  • 3248 = indisponible – quarantaine
  • 3249 = indisponible – réservé
  • 3250 = indisponible – bloqué
  • 3251 = déjà enregistré
  • 4212 = erreur de connexion
  • 4218 = échec de la vérification – erreur de communication
  • 4219 = échec de la création – erreur de communication

Données de retour

En cas de succès, la commande renvoie dans le nœud data :

  • nsset – le nom du NSSET créé

Modèles

Requête JSON :

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-create",
    "clTRID": "your ID",,
    "data": {
      "tld": "cz",
      "name": "NSSET name",
      "dns": {
        "server1": {
          "name": "DNS server name",
          "addr_ipv4": "DNS server IPv4 address",
          "addr_ipv6": "DNS server IPv6 address"
        }
      },
      "tech_c": "technical contact ID"
    }
  }
}

Réponse JSON (OK) :

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-create",
    "data": {
      "nsset": "NSSET name"
    }
  }
}

nsset-update

Utilisez la commande nsset-update pour modifier un NSSET existant. L’ancienne entrée sera entièrement écrasée, saisissez donc toutes les données avec soin.

Paramètres

  • tld – TLD – obligatoire
  • auth_info – AUTH-ID du NSSET – obligatoire
  • name – nom du NSSET – obligatoire
  • dns – liste des serveurs ns, chaque entrée contient les informations sur le serveur ns concerné – obligatoire
    • server – au moins 2 obligatoires
      • name – nom de domaine du serveur – obligatoire
      • addr_ipv4 – adresse IPv4 – facultative
      • addr_ipv6 – adresse IPv6 – facultative
  • tech_c – ID du contact technique – obligatoire

Valeurs de retour

  • 1000 = OK, NSSET modifié
  • 2201 = TLD saisi incorrect
  • 2209 = erreur de syntaxe
  • 2210 = format de la liste des serveurs dns invalide
  • 2211 = trop de serveurs dns
  • 2216 = syntaxe du contact invalide
  • 2247 = NSSET invalide
  • 3214 = erreur – NSSET non chargé
  • 3228 = la gestion des contacts n’est pas prise en charge
  • 3229 = erreur de chargement du contact
  • 3242 = NSSET n’est pas pris en charge pour ce domaine 
  • 3252 = erreur d’autorisation
  • 3254 = échec de la modification du NSSET nsset
  • 4204 = le NSSET est indisponible – erreur de connexion
  • 4220 = échec de la modification du NSSET – erreur de connexion
  • 4212 = le contact est indisponible – erreur de connexion

Données de retour

La requête ne renvoie aucune donnée.

Modèles

Requête JSON :

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-update",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name",
      "auth_info": "NSSET AUTH-ID",
      "dns": {
        "server1": {
          "name": "DNS server name"
        },
        "server2": {
          "name": "DNS server name"
        }
      },
      "tech_c": "technical contact ID"
    }
  }
}

Réponse JSON (OK) :

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-update"
  }
}

nsset-transfer

La commande nsset-transfer change le registrar du NSSET pour WEDOS.

Paramètres

  • tld – TLD
  • name – nom du NSSET
  • auth_info – AUTH-ID du NSSET

Valeurs de retour

  • 1000 = OK
  • 2100 = paramètre obligatoire manquant
  • 2101 = paramètres d’entrée invalides
  • 2201 = TLD non pris en charge
  • 2209 = erreur de syntaxe
  • 2215 = auth_info manquant
  • 2247 = nom de NSSET invalide 
  • 2249 = le transfert de NSSET n’est  pas autorisé pour ce TLD
  • 3214 = erreur – NSSET non chargé
  • 3242 = NSSET non pris en charge
  • 3251 = le NSSET est déjà enregistré chez ce registrar 
  • 3255 = erreur d’autorisation
  • 3256 = échec du transfert du NSSET
  • 4204 = NSSET non chargé – erreur de connexion
  • 4221 = échec du transfert du NSSET – erreur de connexion

Données de retour

La requête ne renvoie aucune donnée.

Modèles

Commande JSON :

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-transfer",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name",
      "auth_info": "NSSET AUTH-ID"
    }
  }
}

Réponse JSON (OK) :

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-transfer"
  }
}

nsset-send-auth-info

La commande nsset-send-auth-info envoie l’AUTH-ID du NSSET à l’adresse e-mail du contact technique du NSSET.

Paramètres

  • tld – TLD
  • name – nom du NSSET

Valeurs de retour

  • 1000 = OK, auth_info envoyé à l’adresse e-mail du contact
  • 2201 = TLD non pris en charge
  • 2209 =  erreur de syntaxe du NSSET
  • 2216 = erreur de syntaxe du contact
  • 2243 = l’envoi du code d’autorisation n’est pas autorisé pour ce NSSET
  • 2247 = format de NSSET non pris en charge
  • 3214 = erreur – échec de la lecture du NSSET
  • 3217 = échec de l’envoi du code d’autorisation
  • 3228 = la gestion des contacts n’est pas prise en charge
  • 3229 = échec de la lecture du contact
  • 3242 = le NSSET n’est pas disponible
  • 3257 = échec de l’envoi, le NSSET n’est pas disponible
  • 4204 = le NSSET n’est pas disponible – échec de la connexion
  • 4212 = le contact n’est pas disponible – échec de la connexion
  • 4222 = échec de l’envoi – échec de la connexion

Données de retour

La requête ne renvoie aucune donnée.

Modèles

Requête JSON :

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-send-auth-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

Réponse JSON (OK) :

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-send-auth-info"
  }
}

Cela vous a-t-il été utile ?

Merci pour votre retour !
Sélecteurs génériques
Correspondances exactes uniquement
Rechercher dans le titre
Rechercher dans le contenu
Sélecteurs de types de contenu
Sommaire de l’article
Parcourir les catégories