Foire aux questions sur l'API de noms de domaine v2 de NiceNIC

L'API de noms de domaine v2 de NiceNIC est une API basée sur HTTPS et JSON permettant d'automatiser la gestion des domaines via votre compte NiceNIC.

Elle prend en charge les flux de travail clés, notamment la vérification de disponibilité des domaines, l'enregistrement, le renouvellement, le transfert, la consultation de portefeuille, la mise à jour des serveurs de noms et des contacts, la tarification, les enregistrements DNS, les serveurs de noms enfants, les informations du compte et les opérations liées à la conformité.

Utilisez l'API lorsque vous souhaitez connecter directement les services de domaine de NiceNIC à un site Web, une plateforme d'hébergement, un système de facturation, un outil interne ou une autre application.

Tout compte NiceNIC actif peut utiliser l'API de noms de domaine v2. L'accès à l'API est disponible aussi bien pour les comptes au tarif de détail que pour les comptes revendeur.

Vous n'avez pas besoin de devenir revendeur simplement pour obtenir un accès à l'API. Le type de compte reste déterminant pour la tarification : les opérations API payantes appliquent les tarifs attribués au compte NiceNIC émetteur de la requête.

Ouvrir les paramètres de l'API →

Oui. L'accès à l'API est lui-même gratuit. Aucun frais distinct n'est facturé pour l'activation de l'accès à l'API ou l'envoi de requêtes API prises en charge.

Les opérations payantes telles que l'enregistrement, le renouvellement et le transfert de domaine sont facturées selon la tarification de votre compte et les règles applicables au domaine.

Non. L'accès à l'API et la tarification revendeur sont distincts.

Vous pouvez utiliser l'API de noms de domaine v2 avec un compte NiceNIC standard au tarif de détail. Passez à un compte revendeur uniquement lorsque la tarification revendeur ou les autres avantages revendeur sont avantageux pour le volume de votre activité.

Comparer les offres revendeur →

L'API de noms de domaine v2 utilise la structure d'API actuelle de NiceNIC avec des requêtes HTTPS, des réponses JSON, une authentification par en-têtes et une documentation organisée autour des flux de travail individuels de domaines et de comptes.

Si vous maintenez une intégration basée sur une version antérieure de l'API NiceNIC, examinez les paramètres de l'API v2 et la gestion des réponses avant de migrer le trafic de production, plutôt que de supposer que les deux versions sont interchangeables.

Connectez-vous à votre compte NiceNIC et ouvrez les Paramètres de l'API. Les requêtes de l'API v2 utilisent votre nom d'utilisateur NiceNIC et votre Secret API pour l'authentification.

Ouvrir les paramètres de l'API →

Oui. NiceNIC met à disposition un bac à sable d'API permettant aux développeurs de tester leurs intégrations avant de les connecter à l'API de production.

Utilisez le bac à sable pour valider l'authentification, le formatage des requêtes, l'analyse des réponses, la gestion des erreurs et le flux de travail de votre application avant d'activer les opérations de domaine réelles pour vos clients.

Ouvrir le bac à sable de l'API →

Le bac à sable de l'API est destiné au développement et aux tests d'intégration. L'API de production sert aux opérations réelles sur les noms de domaine et aux requêtes payantes sur votre compte NiceNIC.

Nous vous recommandons de valider l'authentification, la gestion des requêtes, le traitement des réponses et la logique des erreurs dans le bac à sable avant d'activer les opérations de production destinées aux clients.

Envoyez les requêtes API via HTTPS et incluez votre nom d'utilisateur NiceNIC ainsi que votre secret d'API dans l'en-tête Authorization.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

Si des restrictions d'IP sont activées sur votre compte, les requêtes doivent également provenir d'une adresse IP de serveur autorisée.

Consulter l'authentification API →

Le point de terminaison de base de l'API de production est :

https://api.nicenic.net/v2/

Les actions de l'API sont sélectionnées à l'aide des paramètres documentés pour chaque point de terminaison, tels que category et action. Consultez toujours la documentation dédiée au point de terminaison pour connaître les paramètres obligatoires et facultatifs d'une opération spécifique.

Les réponses de l'API v2 utilisent le format JSON et les paramètres de requête sont encodés en UTF-8.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

Votre application doit vérifier les valeurs de code et msg retournées plutôt que de présumer que chaque réponse HTTP correspond à une opération de domaine finalisée.

Grâce aux API actuellement documentées, vous pouvez automatiser diverses opérations, notamment la vérification de disponibilité des noms de domaine, l'enregistrement, le renouvellement et le transfert, la liste du portefeuille et les détails des domaines, la mise à jour des serveurs de noms et des contacts de domaine, les tarifs des domaines, les enregistrements DNS, les serveurs de noms enfants, les informations de compte ainsi que le suivi des abus et de la conformité.

Les flux de travail supplémentaires sont documentés individuellement dans la navigation de l'API.

Commencez par des opérations de lecture à faible risque telles que la disponibilité du domaine, les tarifs du domaine, le solde du compte et la liste des domaines.

Confirmez ensuite l'authentification, l'analyse des réponses, la gestion des erreurs et le traitement des commandes en attente avant d'activer en production les enregistrements, renouvellements ou transferts.

Oui. Le point de terminaison Vérifier la disponibilité du domaine prend en charge plusieurs noms de domaine séparés par des virgules.

example.com,example.net,example.org

Ne présumez pas que chaque opération de l'API accepte le même format de saisie pour plusieurs domaines. L'enregistrement, le renouvellement et le transfert doivent respecter la documentation de leur propre point de terminaison.

Utilisez le point de terminaison Obtenir les tarifs du domaine. Les types de tarification documentés incluent register, renew, transfer et all.

Les réponses d'enregistrement peuvent également inclure une valeur is_premium indiquant si l'enregistrement interrogé est premium.

Étant donné que les commandes par API appliquent les tarifs associés au compte, vérifiez les prix actuels avant de soumettre des commandes client payantes plutôt que de vous fier indéfiniment à des tarifs en cache.

Non. Bien que la documentation de l'API prenne en charge des durées allant jusqu'à 1–10 ans pour les extensions éligibles, chaque TLD peut être soumis à des règles de registre différentes.

Les périodes d'enregistrement, les périodes de renouvellement, l'éligibilité au transfert, les exigences de contact et les exigences de vérification peuvent varier selon l'extension. Votre application doit respecter les règles en vigueur pour le TLD concerné.

Il s'agit d'opérations distinctes qui ne doivent pas être considérées comme interchangeables.

Fiez-vous toujours au code et au message renvoyés pour déterminer l'état d'une requête API.

Afficher les codes de réponse de l'API →

Une réponse 201 signifie que l'opération a été acceptée pour traitement mais n'a pas nécessairement atteint son état final.

Pour l'enregistrement de domaine, une réponse 201 indique que la commande a été soumise et attend le traitement final par le registre.

N'indiquez pas à un client final que le nom de domaine est actif tant que votre système n'a pas confirmé le résultat définitif. Consultez la documentation du point de terminaison d'enregistrement pour connaître les règles les plus récentes concernant les commandes en attente et le traitement des remboursements.

Un transfert en attente signifie que la demande de transfert a été acceptée pour traitement, et non que le transfert du nom de domaine vers NiceNIC est déjà finalisé.

La finalisation du transfert peut dépendre du traitement par le registre et le bureau d'enregistrement ainsi que du statut actuel du nom de domaine. Maintenez le transfert à l'état en attente jusqu'à ce que la finalisation soit confirmée.

Oui. L'API Lister les noms de domaine prend en charge la récupération du portefeuille avec des options de pagination, de tri et de filtrage.

Utilisez Obtenir les détails du domaine lorsque vous avez besoin d'informations détaillées sur un domaine individuel, telles que les informations d'enregistrement, les informations d'expiration, les serveurs de noms et les données de contact du domaine.

L'API de noms de domaine v2 de NiceNIC comprend des opérations relatives aux abus et à la conformité conçues pour les plateformes et les revendeurs gérant des portefeuilles de domaines clients.

Vous pouvez identifier les domaines associés à des signalements d'abus et récupérer des informations de conformité lisibles par machine pour chaque domaine. Selon le cas, la réponse peut inclure le statut du domaine, l'impact actuel, l'action recommandée, les informations de suspension (hold), les détails de la plainte et les URL signalées.

Cela permet d'afficher le statut de conformité directement dans votre propre portail client ou système opérationnel.

Oui. NiceNIC fournit une intégration bureau d’enregistrement WHMCS pour les entreprises qui utilisent déjà WHMCS pour la facturation et le provisionnement.

Utilisez directement l'API de noms de domaine v2 lorsque vous développez votre propre application ou flux de travail. Utilisez l'intégration WHMCS lorsque vous souhaitez intégrer les opérations de domaine dans un environnement WHMCS existant.

Voir l'intégration WHMCS →

Tout langage de programmation ou environnement d'exécution côté serveur capable d'envoyer des requêtes HTTPS et d'analyser du JSON peut s'intégrer à l'API de noms de domaine v2.

Les choix courants incluent PHP, Python, Node.js et Java. Conservez les identifiants d'API côté serveur et n'exposez jamais votre Secret API dans du JavaScript côté navigateur ou du code client téléchargeable.

Une limitation de débit (rate limiting) peut être appliquée afin de protéger la stabilité de l'API et la sécurité de la plateforme.

Si votre intégration en production doit générer un volume élevé et soutenu de requêtes, contactez NiceNIC avant le lancement afin que votre profil d'utilisation prévu puisse être examiné.

Incluez l'horodatage de la requête, la catégorie et l'action de l'API, le nom de domaine le cas échéant, les paramètres de requête non sensibles, le code et le message de réponse renvoyés, ainsi que l'indication si la requête provient du bac à sable ou de la production.

Soumettre un ticket →

Consultez la navigation de l'API dans la documentation. Chaque opération dispose de sa propre page détaillant les paramètres pris en charge, les exemples de requêtes, les exemples de réponses et les spécificités de son comportement.

La FAQ explique le fonctionnement général de l'API ; la documentation de chaque point de terminaison doit être considérée comme la référence pour le format exact des requêtes.

Ouvrir la documentation de l'API →