API

Enregistrement par fil, contrôles de disponibilité, DNS et gestion dans vos propres systèmes : commandes groupées, balayages de renouvellement, un panneau de contrôle pour vos clients.

Le API est le point d'entrée de la machine vers les mêmes opérations que celles proposées par l'espace client. Ce que vous pouvez faire sur une page, vous pouvez le créer dans un script.

REPOS HTTPS avec réponses JSON

Clés API Créé et révoqué dans l'espace client

Couverture complète Les mêmes opérations que l'espace client

Auditable Les appels sont enregistrés sur le compte

Qu'est-ce que c'est

Les points de terminaison sont regroupés par ressource (disponibilité, domaines, serveurs de noms, contacts, commandes et factures) et renvoient JSON.
L'authentification utilise une clé API générée dans l'espace client, révocable et remplacée à tout moment.
Utilisations typiques : enregistrement groupé, balayages d'expiration, synchronisation de l'état du domaine dans votre propre système, panneau en libre-service pour les clients et flux de travail de certificat automatisés.
Les mêmes règles commerciales s'appliquent que sur le Web : un domaine ne peut pas être enregistré à partir de rien, et un transfert nécessite toujours un domaine déverrouillé et 60 jours.

Comment ça marche

01

Créer une clé

Générez une clé API dans la zone client, adaptée à ce qu'elle doit faire.

02

Lire la documentation

Points finaux, paramètres et formes de réponse.

03

Testez petit

Essayez des points de terminaison en lecture seule, ou quelques domaines, avant d'automatiser.

04

Passez au direct avec la journalisation

Ajoutez des tentatives et une journalisation avant que cela ne touche la production.

Disponibilité et recherche

Vérifiez plusieurs noms à la fois pour le suivi et la sélection.

Inscription et renouvellement

Commandez, renouvelez et lisez le statut de la commande.

DNS et serveurs de noms

Envoyez des enregistrements et des modifications de serveur de noms en masse.

Gestion des contacts

Lisez et mettez à jour le titulaire, l'administrateur, la technologie et la facturation.

Commandes et factures

Lire les commandes, les factures et l'état des paiements.

Rotation des clés

Révoquer et remplacer les clés ; gardez chaque système sur sa propre clé.

Ce que couvre le API

Par ressource

Ressource	Ce que tu peux faire
Domaines	Vérifier la disponibilité, s'inscrire, renouveler, lire le statut et l'expiration
DNS	Lire et définir des serveurs de noms, conserver les enregistrements DNS
Confidentialité et contacts	Définissez le niveau de confidentialité, mettez à jour les quatre rôles de contact
Commandes et facturation	Lire les commandes, les factures et l'état des paiements
Compte	Lire le solde et les détails de base du compte

Ce qu'il faut mettre en place avant de vous connecter

Quatre petites choses qui évitent l'essentiel du débogage

Solde ou mode de paiement fonctionnel : l'enregistrement et le renouvellement sont de véritables commandes, et un appel échouera à l'étape de commande sans fonds.
Nouvelles tentatives et gestion des erreurs : des problèmes de réseau, des limites de débit et des retards en amont se produisent. Réessayez les lectures idempotentes ; pour les commandes, envoyer une référence unique et vérifier avant de réécrire.
Logging : enregistre la référence, le domaine et le code de réponse. Lorsque quelque chose est contesté ultérieurement, ces journaux sont la seule preuve que l'action a eu lieu.
Moyen privilège : n'utilisez pas de clé inscriptible pour un travail en lecture seule et donnez à chaque système sa propre clé afin que l'une puisse être révoquée sans casser les autres.

Une clé API équivaut à un mot de passe de compte. Conservez-le dans une variable d'environnement côté serveur ou dans un gestionnaire de secrets, jamais dans le code front-end et jamais dans un référentiel.

Comment les gens l'utilisent

Modèles courants

Registraire en masse : soumettez une sélection pour l'enregistrement et réécrivez les résultats dans votre propre backend.
Scrutations de renouvellement : extrayez les domaines approchant de l'expiration tous les soirs et lancez vos propres tâches de rappel ou de renouvellement.
Panneaux en marque blanche : permettez à vos clients de gérer les domaines au sein de votre produit, sans se connecter ici.
Réconciliation : extrayez les données de domaine et de commande selon un calendrier et comparez-les à votre propre grand livre.

Ce que comprend chaque commande

Gestion des clés API

Créez, révoquez et séparez les clés par objectif.

Documentation

Points finaux, paramètres et réponses.

Domaine et points de terminaison DNS

Rechercher, enregistrer, renouveler, DNS et serveurs de noms.

Points de terminaison de commande et de facturation

Commandes, factures et état des paiements.

Historique des appels

Enregistré sur le compte pour le dépannage.

Assistance

Ouvrez un ticket si une intégration se comporte mal.

Questions courantes

Y a-t-il des frais supplémentaires pour le API ?

Le API lui-même n'est pas facturé séparément ; vous payez pour les opérations commerciales qu'il effectue. Il existe une limite de débit raisonnable pour éviter toute utilisation accidentelle ou abusive.

Existe-t-il un SDK ?

Le API est le HTTPS et le JSON standard, donc n'importe quel client HTTP fonctionne. La documentation comprend des exemples de requêtes pouvant être adaptées directement.

Et si une clé fuit ?

Révoquez-le dans l'espace client et générez-en un nouveau. La révocation prend effet immédiatement et les demandes utilisant l'ancienne clé sont rejetées.

Les tests coûtent-ils quelque chose ?

Les appels en lecture seule ne coûtent rien. L'enregistrement et le renouvellement sont de véritables commandes et coûtent de l'argent, alors validez d'abord la logique sur un petit nombre de domaines.

Le API peut-il gérer des domaines enregistrés ailleurs ?

Non. Il fonctionne sur les domaines de ce compte, exactement comme le fait l'espace client.

Veuillez noter

Conservez les clés API sur le serveur. Une clé livrée dans le code du navigateur ou dans un forfait mobile est une clé publiée.
Pour commander des points de terminaison, envoyez une référence de demande unique et vérifiez avant d'écrire, afin qu'une nouvelle tentative réseau ne soit pas enregistrée ou facturée deux fois.