Un enregistrement DNS dynamique se met à jour par une simple requête web vers l'API SwissCenter. C'est ce que font les box Internet et les NAS compatibles ; cet article décrit la requête elle-même, pour l'envoyer depuis un script ou un appareil qui n'a pas de réglage tout prêt.
En bref : envoyez une requête POST ou GET en HTTPS vers https://api.swisscenter.com/webservices.php/nic/update avec host, username, password et, facultatif, ip (identifiants du DNS dynamique, pas ceux d'Apanel). L'API répond good, nochg, nohost ou badauth.
Prérequis
Ce qu'il faut savoir avant de commencer
- Les identifiants à utiliser sont ceux que vous avez définis pour ce DNS dynamique dans la fenêtre Ajouter un DNS dynamique, et non ceux de votre console Apanel. N'y mettez jamais le mot de passe de votre compte.
- Le mot de passe circule dans l'adresse de la requête : envoyez-la toujours en HTTPS et ne partagez pas cette adresse.
Comment envoyer la requête de mise à jour ?
Effectuez une requête POST (GET est également accepté) vers l'adresse suivante :
https://api.swisscenter.com/webservices.php/nic/update
L'API nécessite le protocole HTTPS. Voici un exemple de requête :
https://api.swisscenter.com/webservices.php/nic/update?host=__HOSTNAME__&ip=__MYIP__&username=__USERNAME__&password=__PASSWORD__
Remplacez les valeurs d'exemple par les vôtres :
host : le nom d'hôte complet du DNS dynamique (par exemple maison.votresite.ch) ;username et password : le nom d'utilisateur et le mot de passe de ce DNS dynamique ;ip : l'adresse à publier. Ce paramètre est facultatif : sans lui, l'API publie l'adresse IP d'où part la requête.
L'API choisit elle-même le type d'enregistrement selon l'adresse : A pour une adresse IPv4, AAAA pour une adresse IPv6.
Que signifie la réponse de l'API ?
L'API répond par un mot :
| Réponse |
Signification |
good |
L'adresse a été mise à jour. |
nochg |
L'adresse publiée est déjà celle-ci : rien n'a changé. |
nohost |
Aucun DNS dynamique ne correspond à ce nom d'hôte avec ces identifiants. |
badauth |
Un paramètre manque ou n'est pas valable (nom d'utilisateur, nom d'hôte ou adresse IP). |
En cas de problème
nohost : vérifiez que host contient le nom d'hôte complet et que le nom d'utilisateur et le mot de passe sont bien ceux du DNS dynamique. En cas de doute, changez le mot de passe du DNS dynamique dans la console Apanel et reportez-le dans votre requête.badauth : un des quatre paramètres est vide ou mal formé. Contrôlez l'orthographe des paramètres et l'adresse IP si vous la précisez.good mais le nom répond encore l'ancienne adresse : les résolveurs gardent l'ancienne réponse en cache jusqu'à expiration de son TTL ; patientez, puis vérifiez dans l'historique des modifications DNS que la mise à jour a bien été reçue.
Pour aller plus loin