WAPI - NSSET

Cet article fournit des informations sur les demandes suivantes :

• nsset-check - Vérification de la disponibilité de NSSET
• nsset-info - Informations sur NSSET
• nsset-create - Créer un NSSET
• nsset-update - mise à jour de NSSET
• nsset-transfer - transfert de NSSET à partir d'un autre bureau d'enregistrement
• nsset-send-auth-info - envoi de l'identifiant NSSET AUTH-ID

---

nsset-check

Utilisez la requête nsset-check pour vérifier si le nom NSSET est libre d'enregistrement ou s'il se trouve dans un autre état.

Paramètres

• tld - domaine TLD
• name - Nom du NSSET

Valeurs de retour

• 1000 = NSSET est disponible pour l'enregistrement
• 2201 = TLD non valide
• 2247 = format NSSET non pris en charge
• 3242 = NSSET n'est pas disponible
• 3245 = 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 demande ne renvoie aucune donnée.

Modèles

Demande 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 requête nsset-info pour télécharger des informations sur un NSSET.

Paramètres

• tld - TLD
• name - Nom du NSSET

Valeurs de retour

• 1000 = OK
• 2201 = TLD non valide
• 2209 = erreur de syntaxe
• 2247 = format NSSET non pris en charge 
• 3214 = erreur - NSSET non chargé
• 3242 = NSSET n'est pas disponible
• 4204 = erreur de connexion, réessayer plus tard

Données de retour

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

• name - Nom du NSSET
• statut - statut
• reg_owner - registraire actuel
• reg_creator - Créateur de NSSET (registraire)
• reg_update - registrar qui a effectué la dernière mise à jour
• created_date - date de création
• updated_date - date de la dernière mise à jour
• transfer_date - date du transfert vers un autre bureau d'enregistrement
• tech_c - Contact technique NSSET
• dns - Liste des serveurs DNS
• serveur
  • name - nom du serveur
  • addr_ipv4 - Adresse IPv4 du serveur
  • addr_ipv6 - Adresse du serveur IPv6

Modèles

Demande 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 requête nsset-create pour créer un nouveau NSSET. Le NSSET contient une liste de serveurs NS, chaque serveur contient une entrée de nom et éventuellement son adresse IP. Vous pouvez également définir un contact technique - si vous ne le faites pas, le contact par défaut (WEDOS) sera défini.

Paramètres

• tld - TLD
• name - Nom du NSSET
• dns - liste de serveurs ns, chaque entrée de serveur contient des informations sur ce serveur ns
  • serveur
    • name - nom (adresse du domaine)
    • addr_ipv4 - Adresse IPv4
    • addr_ipv6 - Adresse IPv6
• tech_c - contact technique - optionnel

Valeurs de retour

• 1000 = OK, NSSET créé
• 2201 = mauvais TLD saisi
• 2210 = format non valide des serveurs ns
• 2211 = trop de serveurs ns
• 2216 = syntaxe non valide dans le contact technique 
• 2247 = format NSSET non pris en charge 
• 3228 = ne soutient pas le travail avec les contacts
• 3229 = erreur de chargement du contact
• 3242 = NSSET n'est pas disponible
• 3244 = Échec de la création d'un NSSET
• 3245 = 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 du contrôle - erreur de communication
• 4219 = échec de la création - erreur de communication

Données de retour

En cas de succès, la commande dans le nœud de données est renvoyée :

• nsset - le nom du NSSET créé

Modèles

Demande 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 requête nsset-update pour modifier un NSSET existant. L'ancienne entrée sera complètement écrasée, il convient donc de saisir toutes les données avec soin.

Paramètres

• tld - TLD
• name - Nom du NSSET
• dns - liste de serveurs ns, chaque entrée de serveur contient des informations sur ce serveur ns
  • serveur
    • name - nom de domaine du serveur
    • addr_ipv4 - Adresse IPv4
    • addr_ipv6 - Adresse IPv6
• tech_c - identifiant du contact technique - facultatif

Valeurs de retour

• 1000 = OK, NSSET modifié
• 2201 = saisie d'un mauvais TLD
• 2209 = erreur de syntaxe
• 2210 = format invalide de la liste des serveurs DNS
• 2211 = trop de serveurs DNS
• 2216 = syntaxe non valide dans le contact
• 2247 = NSSET non valide
• 3214 = erreur - NSSET non chargé
• 3228 = ne soutient pas le travail avec les contacts
• 3229 = erreur de chargement du contact
• 3242 = NSSET n'est pas supporté pour ce domaine 
• 3252 = erreur d'autorisation
• 3254 = Échec de la modification du NSSET nsset
• 4204 = NSSET n'est pas disponible - erreur de connexion
• 4220 = Échec de la modification du NSSET - erreur de connexion
• 4212 = le contact n'est pas disponible - erreur de connexion

Données de retour

La demande ne renvoie aucune donnée.

Modèles

Demande JSON :

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-update",
    "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-update"
  }
}

---

nsset-transfer

La demande nsset-transfer change le registraire NSSET en WEDOS.

Paramètres

• tld - TLD
• name - Nom du NSSET
• auth_info - NSSET AUTH-ID

Valeurs de retour

• 1000 = OK
• 2100 = le paramètre requis est manquant
• 2101 = paramètres d'entrée non valides
• 2201 = TLD non pris en charge
• 2209 = erreur de syntaxe
• 2215 = auth_info manquant
• 2247 = nom NSSET non valide 
• 2249 = Le transfert NSSET n'est pas autorisé pour ce TLD
• 3214 = erreur - NSSET non chargé
• 3242 = NSSET non pris en charge
• 3251 = NSSET est déjà enregistré auprès de ce bureau d'enregistrement 
• 3255 = erreur d'autorisation
• 3256 = Échec du transfert NSSET
• 4204 = NSSET non chargé - erreur de connexion
• 4221 = Échec du transfert NSSET - erreur de connexion

Données de retour

La demande 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 demande nsset-send-auth-info envoie l'identifiant NSSET AUTH-ID à l'adresse électronique du contact technique NSSET.

Paramètres

• tld - TLD
• name - Nom du NSSET

Valeurs de retour

• 1000 = OK, auth_info envoyé à l'e-mail du contact
• 2201 = TLD non pris en charge
• 2209 = erreur de syntaxe NSSET
• 2216 = erreur de syntaxe du contact
• 2243 = ce NSSET n'est pas autorisé à envoyer le code d'autorisation
• 2247 = le format NSSET n'est pas pris en charge
• 3214 = erreur - La lecture de NSSET a échoué
• 3217 = l'envoi du code d'autorisation a échoué
• 3228 = ne permet pas de travailler avec des contacts
• 3229 = échec de la lecture du contact
• 3242 = NSSET n'est pas disponible
• 3257 = échec de l'envoi, NSSET n'est pas disponible
• 4204 = NSSET n'est pas disponible - échec de la connexion
• 4212 = le contact n'est pas disponible - la connexion a échoué
• 4222 = échec de l'envoi - échec de la connexion

Données de retour

La demande ne renvoie aucune donnée.

Modèles

Demande 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"
  }
}