Cet article traite des commandes WAPI propres au service WEDOS DNS. Pour savoir comment configurer WAPI et résoudre les problèmes courants, voir l’article WAPI – Manuel.
Cet article fournit des informations sur les requêtes suivantes :
- dns-domains-list – liste des domaines DNS du compte de l'utilisateur
- dns-domain-info – informations sur le domaine
- dns-domain-add – ajouter un domaine au DNS
- dns-domain-update – mettre à jour le domaine dans le DNS
- dns-domain-delete – supprimer un domaine du DNS
- dns-domain-axfr-run – demander un transfert AXFR du serveur primaire vers notre DNS
- dns-domain-axfr-tsig – mettre à jour ou vérifier les paramètres AXFR TSIG
- dns-domain-copy – ajouter un domaine au DNS en copiant un autre domaine
- dns-domain-commit – enregistrer les modifications DNS
- dns-rows-list – récupérer la liste des enregistrements du domaine
- dns-row-detail – récupérer le détail d'un enregistrement
- dns-row-add – ajouter un enregistrement
- dns-row-update – modifier un enregistrement
- dns-row-delete – supprimer un enregistrement
dns-domains-list
Utilisez dns-domains-list requête pour lister les domaines DNS de l'utilisateur.
Paramètres
- search – chaîne à rechercher parmi les noms de domaine – facultatif
- status – filtrer par statut (active, disabled) – facultatif
- type – filtrer par type de domaine (primary, secondary) – facultatif
- page – numéro de page (par défaut : 1) – facultatif
- page_limit – nombre d'entrées par page (par défaut : 50) – facultatif
- orderby – trier les entrées par created_date ou domain, suivi de asc/desc – facultatif, voir le modèle
Valeurs de retour
- 1000 – OK
Données de la réponse
La requête renvoie une liste de domaines selon ce modèle :
- domaine
- name – nom de domaine
- status – statut du domaine dans le système
- type – type (primary/secondary)
Modèles
Requête JSON :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domains-list",
"clTRID": "your ID",
"data": {
"search": "search term in domain name",
"status": "active|disabled",
"type": "primary|secondary",
"page": "page number",
"page_limit": "number of entries per page",
"orderby":"domain|created_date asc|desc"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domains-list",
"data": {
"domain": [
{
"name": "domain1 name in DNS",
"type": "type (primary|secondary)",
"status": "active|disabled"
}
],
"total": "počet položek celkem",
"page": "číslo stránky",
"page_limit": "počet položek na stránku"
}
}
}
dns-domain-info
Utilisez dns-domain-info requête pour obtenir les informations de base sur un ou plusieurs domaines dans le système DNS de WEDOS (WDNS).
Paramètres
- name – nom de domaine, pour plusieurs domaines utilisez une chaîne séparée par des virgules (voir le modèle) – obligatoire
Valeurs de retour
- 1000= OK
- 2201= TLD non pris en charge
- 2202= nom de domaine invalide
- 3222= échec de l'ouverture du domaine
- 3223= erreur d'autorisation
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
La valeur de retour pour plusieurs domaines est toujours 1000. Les éventuelles valeurs d’erreur sont affichées dans domaine données, comme indiqué dans le modèle.
Données de retour
En cas de succès, la requête renvoie le détail du domaine dans WDNS, dans le nœud data/domain.
Modèles
Requête JSON avec 2 domaines :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-info",
"clTRID": "your ID",
"data": {
"name": "domain.name1, domain.name2"
}
}
}
Réponse JSON (domain.name1 OK, domain.name2 erreur) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-info",
"data": {
"domain": [{
"name": "domain.name1",
"status": "",
"type": "",
"tlock": "",
"autocommit": "",
"axfr_enabled": "outgoing axfr enabled? (0/1)",
"axfr_ips": "allowed axfr IPs list",
"changed": "",
"changed_date": "",
"commit_date": "",
"reload_pending": "",
"reload_pending_date": "",
"reload_date": "",
"disabled_date": "",
"enabled_date": "",
"add_date": "",
"rname": "",
"serial": "",
"refresh": "",
"retry": "",
"expire": "",
"minimum": "",
"rr_cnt6": "",
"ns_out": "",
"ns1": ""
},
{
"name": "domain.name2",
"code": 3222,
"result": "Domain open failed"
}]
}
}
}
dns-domain-add
Utilisez dns-domain-add requête pour ajouter un nouveau domaine au DNS.
Paramètres
- name – nom de domaine, ou plusieurs noms séparés par des virgules (obligatoire)
- type – type d'enregistrement du domaine (primary/secondary) – facultatif (par défaut : primary)
- axfr_enabled – l'axfr sortant est-il activé ? (0/1) – domaines primaires uniquement, facultatif (par défaut : 0)
- axfr_ips – liste des adresses ip autorisées pour l'axfr (uniquement pour une entrée primary, saisissez plusieurs adresses sous forme de liste séparée par des espaces ; obligatoire si axfr_enabled=1)
- primary_ip – adresses ip du serveur dns primaire (obligatoire si type=secondary)
- primary_tsig_enabled – TSIG est-il activé ? (0/1) – domaines secondaires uniquement, facultatif
- primary_tsig_name – identifiant TSIG – domaines secondaires uniquement, obligatoire si TSIG est activé
- primary_tsig_alg – algorithme TSIG – domaines secondaires uniquement, obligatoire si TSIG est activé
- primary_tsig_key – clé TSIG – domaines secondaires uniquement, obligatoire si TSIG est activé
- template_id – ID d'un domaine de type modèle – domaine primaire uniquement, facultatif
Valeurs de retour
- 1000 = ok
- 2007 = taille maximale de la requête dépassée
- 2100 = paramètre obligatoire manquant
- 2101= paramètres d'entrée invalides
- 2201 = TLD non pris en charge
- 2202 = nom de domaine invalide
- 2301 = mauvais format de type
- 2302 = paramètre primary_ip manquant
- 2303 = mauvais format de primary_ip
- 2304 = format axfr_enabled invalide
- 2305 = paramètre obligatoire axfr_ips manquant
- 2306 = format de axfr_ips invalide
- 2308 = format de ns invalide
- 2322 = limite de domaines dans le DNS par utilisateur atteinte
- 2323 = modèle introuvable
- 2324 = impossible de créer un domaine primaire à partir d'un modèle
- 2325 = modèle non défini
- 2330 = Requête invalide – domaine WDNS – TSIG primaire – configuration invalide
- 2331 = Requête invalide – domaine WDNS – TSIG primaire – format de nom invalide
- 2332 = Requête invalide – domaine WDNS – TSIG primaire – format d'algorithme invalide
- 2333 = Requête invalide – domaine WDNS – TSIG primaire – format de clé invalide
- 2340 = nombre max. de domaines pour une seule action dépassé
- 3302 = échec de l'ajout du domaine au DNS
- 3303 = le domaine existe déjà dans le DNS
Données de retour
La requête ne renvoie aucune donnée.
Modèles
Requête JSON – domaine primaire :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-add",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld",
"axfr_enabled": "0 or 1",
"axfr_ips": "allowed AXFR address(es)",
"template_id": "ID of domain records template"
}
}
}
Requête JSON – domaine secondaire :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-add",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld",
"type": "secondary",
"primary_ip": "primary IP address",
"primary_tsig_enabled": "0 or 1",
"primary_tsig_name": "tsig_identifier",
"primary_tsig_alg": "hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512 or hmac-md5",
"primary_tsig_key": "TSIG_key_value"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-add"
}
}
Réponse JSON pour plusieurs domaines :
{
"response":{
"code":1000,
"result":"OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-add",
"data": [
{
"code":1000,
"result":"OK",
"name":"domain1.tld",
"domain_id":"service ID"
},
{
"code":1000,
"result":"OK",
"name":"domain2.tld",
"domain_id":"service ID"
}
]
}
}
dns-domain-update
Utilisez dns-domain-update requête pour modifier le domaine dans le DNS.
Paramètres
- name – nom de domaine, ou plusieurs noms séparés par des virgules (obligatoire)
- axfr_enabled – l'axfr sortant est-il activé ? (0/1) – domaines primaires uniquement, facultatif (par défaut : 0)
- axfr_ips – liste des adresses ip autorisées pour l'axfr (uniquement pour une entrée primary, obligatoire si axfr_enabled=1)
- ip – adresse ip pour l'axfr sortant
- primary_ip – adresses ip du serveur dns primaire (obligatoire si type=secondary)
- primary_tsig_enabled – TSIG est-il activé ? (0/1) – domaines secondaires uniquement, facultatif
- primary_tsig_name – identifiant TSIG – domaines secondaires uniquement, obligatoire si TSIG est activé
- primary_tsig_alg – algorithme TSIG – domaines secondaires uniquement, obligatoire si TSIG est activé
- primary_tsig_key – clé TSIG – domaines secondaires uniquement, obligatoire si TSIG est activé
Valeurs de retour
- 1000 = ok
- 2007= taille maximale de la requête dépassée
- 2100 = paramètre obligatoire manquant
- 2101= paramètres d'entrée invalides
- 2201 = TLD non pris en charge
- 2202 = nom de domaine invalide
- 2302 = paramètre primary_ip manquant
- 2303 = mauvais format de primary_ip
- 2304 = format axfr_enabled invalide
- 2305 = paramètre obligatoire axfr_ips manquant
- 2306 = format de axfr_ips invalide
- 2308 = format de ns invalide
- 2322 = limite de domaines dans le DNS par utilisateur atteinte
- 2330 = Requête invalide – domaine WDNS – TSIG primaire – configuration invalide
- 2331 = Requête invalide – domaine WDNS – TSIG primaire – format de nom invalide
- 2332 = Requête invalide – domaine WDNS – TSIG primaire – format d'algorithme invalide
- 2333 = Requête invalide – domaine WDNS – TSIG primaire – format de clé invalide
- 2340= nombre max. de domaines pour une seule action dépassé
- 3302 = échec de l'ajout du domaine au DNS
- 3303 = le domaine existe déjà dans le DNS
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": "dns-domain-update",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld",
"axfr_enabled": "0 or 1",
"axfr_ips": "allowed AXFR IP address(es)",
"primary_ip": "primary IP adderess",
"primary_tsig_enabled": "0 or 1",
"primary_tsig_name": "tsig_identifier",
"primary_tsig_alg": "hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512 or hmac-md5",
"primary_tsig_key": "TSIG_key_value"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-update"
}
}
Réponse JSON pour plusieurs domaines (OK) :
{
"response":{
"code":1000,
"result":"OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-update",
"data": [
{
"code":1000,
"result":"OK",
"name":"domain1.tld",
},
{
"code":1000,
"result":"OK",
"name":"domain2.tld",
}
]
}
}
dns-domain-delete
Utilisez dns-domain-delete requête pour supprimer un domaine du DNS, y compris tous ses enregistrements.
Paramètres
- name – nom de domaine, ou plusieurs noms séparés par des virgules (obligatoire)
Valeurs de retour
- 1000 = ok
- 2007= taille maximale de la requête dépassée
- 2340= nombre max. de domaines pour une seule action dépassé
- 3222= échec de l'ouverture du domaine
- 3223= accès refusé
- 3301= l'enregistrement ne peut pas être supprimé
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
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": "dns-domain-delete",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",,
"command": "dns-domain-delete"
}
}
Réponse JSON pour plusieurs domaines (OK) :
{
"response":{
"code":1000,
"result":"OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-delete",
"data": [
{
"code":1000,
"result":"OK",
"name":"domain1.tld",
},
{
"code":1000,
"result":"OK",
"name":"domain2.tld",
}
]
}
}
dns-domain-axfr-run
Le dns-domain-axfr-run requête met à jour les enregistrements DNS depuis le serveur autoritaire primaire via AXFR dès que possible (en quelques minutes). Elle est utilisée pour les domaines secondaires, dont nous téléchargeons le contenu de la zone dans notre système depuis un autre serveur.
Sans cette requête, l’AXFR utilise les valeurs REFRESH et RETRY de l’enregistrement SOA.
Paramètres
- name – nom de domaine – obligatoire
Valeurs de retour
- 1000 = ok
- 2201= TLD non pris en charge
- 2202= nom de domaine invalide ou non pris en charge
- 2319= possible uniquement pour un domaine de type secondaire
- 3222= échec de l'ouverture du domaine
- 3223= accès refusé
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
Données de retour
- next_run – heure à laquelle la prochaine mise à jour aura lieu
Modèles
Requête JSON :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-axfr-run",
"clTRID": "your ID",
"data": {
"name": "domain name"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-axfr-run",
"data": {
"next_run": "date and time of next update"
}
}
}
dns-domain-axfr-tsig
Le dns-domain-axfr-tsig requête sert à créer/mettre à jour, supprimer ou afficher les informations de clé AXFR TSIG pour un ou plusieurs domaines.
TSIG (Transaction Signature) est un mécanisme d’authentification des transferts DNS (AXFR/IXFR) qui assure la vérification de l’identité entre le serveur primaire et le serveur secondaire. Cette vérification sera exigée pour tous les transferts vers les serveurs DNS secondaires et doit correspondre exactement à sa configuration.
Si le serveur primaire n’utilise pas TSIG, n’activez pas cette option, sinon le transfert AXFR échouera.
Paramètres
- name – nom de domaine, ou plusieurs noms séparés par des virgules (obligatoire)
- axfr_tsig_action – action AFXR TSIG – obligatoire
- créer – activer ou mettre à jour AXFR TSIG
- annuler – désactiver AXFR TSIG
- info – afficher les informations AXFR TSIG
Valeurs de retour
- 1000 = ok
- 2201= TLD non pris en charge
- 2202= nom de domaine invalide ou non pris en charge
- 2319= possible uniquement pour un domaine de type secondaire
- 2334 = AXFR TSIG non défini
- 2335 = AXFR TSIG non créé
- 2336 = AXFR TSIG non désactivé
- 2337 = commande AXFR TSIG invalide
- 2340 = nombre max. de domaines pour une seule action dépassé
- 3222= échec de l'ouverture du domaine
- 3223= accès refusé
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
Données de retour
- name = nom de domaine
- axfr_tsig_action – nom de l'action AFXR TSIG
- axfr_tsig_name – nom de la clé AXFR TSIG
- axfr_tsig_alg – algorithme de la clé AXFR TSIG
- axfr_tsig_key – valeur de la clé AXFR TSIG
Modèles
Requête JSON :
{
"request":{
"user": "your@login.tld",
"auth": "authentication string",
"command":"dns-domain-axfr-tsig",
"clTRID": "your ID",
"data":{
"name":"domain1.tld, domain2.tld",
"axfr_tsig_action":"create, cancel, or info"
}
}
}
Réponse JSON pour la commande create (plusieurs états de domaine) :
{
"response":{
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-axfr-tsig",
"data": [
{
"name":"domain1.tld",
"code":1000,
"result":"OK",
"axfr_tsig_action":"create",
"axfr_tsig_name":"keyname",
"axfr_tsig_alg":"hmac-sha256",
"axfr_tsig_key":"lbOYAMGHc6eSo3R2h6rWrHcsp3iSBp/0D0S7kjRqxLI="
},
{
"name":"domain-swapi-00003y.cz",
"code":3222,
"result":"Domain open failed",
"axfr_tsig_action":"create"
}
]
}
}
dns-domain-copy
Utilisez dns-domain-copy commande pour ajouter un domaine au DNS en copiant les paramètres et les enregistrements d’un autre domaine existant.
Paramètres
- name – nom du domaine d'origine (celui que vous voulez copier) – obligatoire
- name_new – nom du domaine nouvellement créé – obligatoire
Valeurs de retour
- 1000 = ok
- 2201= TLD non pris en charge
- 2202= nom du domaine existant invalide ou non pris en charge
- 2320= nom du nouveau domaine invalide ou non pris en charge
- 2321= TLD du nouveau nom de domaine non pris en charge
- 2322= limite du nombre de domaines dans le DNS par utilisateur atteinte
- 3222= échec de l'ouverture du domaine
- 3223= accès refusé
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
- 3311= échec de la copie
- 3312= le nouveau domaine existe déjà dans le DNS
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": "dns-domain-copy",
"clTRID": "your ID",
"data": {
"name": "original domain name",
"name_new": "new domain name"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-copy"
}
}
dns-domain-commit
Utilisez dns-domain-commit requête après avoir effectué des modifications sur le domaine ou ses enregistrements DNS. Vous confirmez les modifications et demandez leur distribution aux serveurs DNS.
Si vous n’exécutez pas la dns-domain-commit commande, le système l’exécutera automatiquement 5 minutes après la dernière modification.
Paramètres
- name – nom de domaine – obligatoire
Valeurs de retour
- 1000 = ok
- 2201= TLD non pris en charge
- 2202= nom de domaine invalide ou non pris en charge
- 3222= échec de l'ouverture du domaine
- 3223= accès refusé
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
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": "dns-domain-commit",
"clTRID": "your ID",
"data": {
"name": "domain name"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-commit"
}
}
dns-rows-list
Utilisez dns-rows-list requête pour obtenir la liste des enregistrements de domaine dans le DNS avec les informations de base.
Pour obtenir des informations plus détaillées sur un enregistrement précis, utilisez dns-row-detail requête.
Paramètres
- domaine – nom de domaine – obligatoire
Valeurs de retour
- 1000 = ok
- 2201= TLD non pris en charge
- 2202= nom de domaine invalide ou non pris en charge
- 2318= ne peut pas être effectué sur un domaine de type secondaire
- 3222= échec de l'ouverture du domaine
- 3223= accès refusé
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
Données de la réponse
- row – enregistrement
- ID – ID de l'enregistrement
- name – nom de l'enregistrement
- ttl – TTL de l'enregistrement
- rdtype – type d'enregistrement
- rdata – données de l'enregistrement
- changed_date – date de modification
- author_comment – commentaire
Modèles
Requête JSON :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-rows-list",
"clTRID": "your ID",
"data": {
"domain": "domain name"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-rows-list",
"data": {
"row1": {
"ID": "record ID",
"name": "record name (may be empty)",
"ttl": "TTL",
"rdtype": "record type",
"rdata": "record data",
"changed_date": "date and time of last update",
"author_comment": "comment"
}
}
}
}
dns-row-detail
Le dns-row-detail requête renvoie des informations détaillées sur un enregistrement DNS de domaine donné.
Pour obtenir la liste complète des enregistrements d’un domaine, utilisez dns-rows-list requête.
Paramètres
- name – nom de domaine – obligatoire
- row_id – ID de l'enregistrement – obligatoire, obtenu depuis dns-rows-list
Valeurs de retour
- 1000 = ok
- 2201= TLD non pris en charge
- 2202= nom de domaine invalide ou non pris en charge
- 2318= Cette action ne peut pas être effectuée sur un domaine de type secondaire
- 3222= échec de l'ouverture du domaine
- 3223= accès refusé
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
- 3309= l'enregistrement DNS requis pour le domaine n'existe pas
Données de retour
- row – enregistrement
- ID – ID de l'enregistrement
- name – nom de l'enregistrement
- ttl – TTL de l'enregistrement
- rdtype – type d'enregistrement
- rdata – données de l'enregistrement
- changed_date – date de modification
- author_comment – commentaire
Modèles
Requête JSON :
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-detail",
"clTRID": "your ID",
"data": {
"name": "název domény",
"row_id": "ID záznamu"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-detail",
"data": {
"row1": {
"ID": "record ID",
"name": "record name (may be empty)",
"ttl": "TTL",
"rdtype": "record type",
"rdata": "record data",
"changed_date": "date and time of last update",
"author_comment": "comment"
}
}
}
}
dns-row-add
Le dns-row-add requête ajoute un nouvel enregistrement DNS au domaine.
Paramètres
- domaine – nom de domaine – obligatoire
- name – nom de l'enregistrement – obligatoire, mais peut être vide
- ttl – valeur TTL – obligatoire
- type – type d'enregistrement – obligatoire
- rdata – données de l'enregistrement – obligatoire
- author_comment – commentaire de l'auteur – facultatif. L'envoi d'une chaîne vide efface le commentaire précédent.
Valeurs de retour
- 1000 = ok
- 2100 = paramètre obligatoire manquant
- 2201= TLD non pris en charge
- 2202= nom de domaine invalide ou non pris en charge
- 2309= type d'enregistrement invalide
- 2310= impossible d'ajouter un autre enregistrement au domaine
- 2311= nom invalide
- 2312= nom invalide pour ce type d'enregistrement
- 2313= CNAME invalide pour ce name
- 2314= données de l'enregistrement invalides
- 2315= TLD invalide
- 2316= cet enregistrement existe déjà
- 2317= TTL invalide
- 2318= l'action ne peut pas être effectuée sur un domaine de type secondaire
- 3222= échec de l'ouverture du domaine
- 3223= accès refusé
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
- 3307 = échec de l'ajout de l'enregistrement de domaine
- 5001 = erreur interne d'authentification
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": "dns-row-add",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"name": "record name (may be empty)",
"ttl": "TTL",
"type": "record type",
"rdata": "record data"
}
}
}
Requête JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-add",
}
}
dns-row-update
Utilisez dns-row-update requête pour modifier un enregistrement DNS.
Vous ne pouvez pas modifier le nom et le type d’un enregistrement. Dans ce cas, supprimer l’enregistrement d’origine puis en créer un nouveau.
Paramètres
- domaine – nom de domaine – obligatoire
- row_id – ID de l'enregistrement – obligatoire, obtenu depuis dns-rows-list
- ttl – valeur TTL – obligatoire
- rdata – données de l'enregistrement – obligatoire
- author_comment – commentaire de l'auteur – facultatif. L'envoi d'une chaîne vide efface le commentaire précédent.
Valeurs de retour
- 1000 = ok
- 2100 = paramètre obligatoire manquant
- 2201= TLD non pris en charge
- 2202= nom de domaine invalide ou non pris en charge
- 2309= type d'enregistrement invalide
- 2310= impossible d'ajouter un autre enregistrement au domaine
- 2311= nom invalide
- 2312= nom invalide pour ce type d'enregistrement
- 2313= CNAME invalide pour ce name
- 2314= données de l'enregistrement invalides
- 2315= TLD invalide
- 2316= cet enregistrement existe déjà
- 2317= TTL invalide
- 2318= l'action ne peut pas être effectuée sur un domaine de type secondaire
- 3222= échec de l'ouverture du domaine
- 3223= accès refusé
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
- 3310 = échec de la mise à jour de l'enregistrement de domaine
- 5001 = erreur interne d'authentification
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": "dns-row-update",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"row_id": "row ID",
"ttl": "TTL",
"rdata": "record data"
}
}
}
Réponse JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-update"
}
}
dns-row-delete
Utilisez dns-row-delete requête pour supprimer un enregistrement DNS d'un domaine.
Paramètres
- domaine – nom de domaine – obligatoire
- row_id – ID de l'enregistrement – obligatoire, obtenu depuis dns-rows-list
Valeurs de retour
- 1000 = ok
- 2201= TLD non pris en charge
- 2202= nom de domaine invalide ou non pris en charge
- 2318= action invalide pour un domaine de type secondaire
- 3222= échec de l'ouverture du domaine
- 3223= accès refusé
- 3305= le domaine est verrouillé en modification
- 3306= le domaine est supprimé
- 3308= échec de la suppression de l'enregistrement
- 3309= l'enregistrement portant cet ID n'existe pas
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": "dns-row-delete",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"row_id": "record ID"
}
}
}
Requête JSON (OK) :
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-delete",
}
}
Cela vous a-t-il été utile ?
Merci pour votre retour !