Vue d'ensemble de l'API
Documentation de l'API de noms de domaine v2 NiceNIC et démarrage rapide
L'API de noms de domaine v2 de NiceNIC est disponible pour les comptes au tarif de détail comme pour les comptes revendeur. Utilisez cette vue d'ensemble pour configurer l'accès, confirmer votre première requête, comprendre le modèle de réponse de l'API et accéder directement à la section appropriée dans la navigation de gauche.
L'accès à l'API et les tarifs revendeur sont distincts.
Compte au tarif de détail : accès à l'API avec les tarifs du compte au détail.
Compte revendeur : accès à l'API avec les tarifs appliqués au niveau revendeur actuel.
Comparer les niveaux de revendeur et les tarifs →
Compte au tarif de détail : accès à l'API avec les tarifs du compte au détail.
Compte revendeur : accès à l'API avec les tarifs appliqués au niveau revendeur actuel.
Comparer les niveaux de revendeur et les tarifs →
Point de terminaison de base
https://api.nicenic.net/v2/
En-têtes requis
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Réponse standard de succès
{ "code": 0, "msg": "success", "data": {} }
Bac à sable API
Testez votre intégration avant le passage en production
Utilisez le bac à sable de l'API NiceNIC pour tester l'intégration de votre API de noms de domaine avant le passage en production. Validez l'authentification, les requêtes API, la gestion des réponses et le flux de votre application dans un environnement de test dédié.
Idéal pour les revendeurs, hébergeurs, développeurs et plateformes préparant une intégration d'API.
Démarrage rapide
Effectuez votre premier appel d'API en 4 étapes
Commencez par une requête en lecture seule avant d'activer les enregistrements, renouvellements ou transferts réels. Cela vous permet de valider l'authentification, le formatage des requêtes et le traitement des réponses sans passer de commande payante.
1
Activer l'accès à l'API
Ouvrez les Paramètres de l'API, créez ou récupérez votre secret d'API et configurez les adresses IP de serveur autorisées le cas échéant.
2
Confirmer l'authentification
Utilisez HTTPS avec l'en-tête Authorization au format username:api_secret.
3
Exécuter un test sans risque
Commencez par la disponibilité des domaines, la tarification, le solde du compte ou la liste des domaines.
4
Traiter la réponse
Lisez et enregistrez le code et le msg renvoyés avant d'activer des opérations payantes en production.
Première requête recommandée : Disponibilité du nom de domaine
Le point de terminaison de disponibilité prend en charge plusieurs noms de domaine en une seule requête en les séparant par des virgules.
curl "https://api.nicenic.net/v2/?category=domain&action=check&domains=example.com,example.net" \ -H "Authorization: username:api_secret" \ -H "Content-Type: application/json"
Plan de l'API
Choisissez le flux de travail dont vous avez besoin
L'aperçu ci-dessous reflète la navigation de gauche. Utilisez-le pour identifier le bon flux de travail, puis ouvrez la page dédiée au point de terminaison pour consulter les paramètres ainsi que les exemples de requêtes et de réponses.
| Section | Cas d'usage | Fonctions documentées |
|---|---|---|
| Premiers pas | Connectez-vous en toute sécurité et découvrez la gestion des réponses. | Présentation de l'API, environnement de test de l'API, authentification, codes de réponse. |
| Gestion des domaines | Automatisez le cycle de vie principal des domaines. | Disponibilité, Liste des domaines, Détails du domaine, Enregistrement, Renouvellement, Transfert entrant, Serveurs de noms, Contacts, Tarifs. |
| Abus et conformité | Surveiller les noms de domaine nécessitant une attention de conformité. | Répertoriez les domaines faisant l'objet de signalements d'abus et récupérez un statut d'abus lisible par machine, le cycle de vie du blocage, les informations sur les plaintes ainsi que l'action recommandée. |
| Enregistrements DNS | Gérer les enregistrements DNS hébergés par programmation. | Lister, créer, mettre à jour et supprimer des enregistrements DNS. |
| Serveurs de noms enfants | Gérez les hôtes / enregistrements glue pour les serveurs de noms sous votre propre domaine. | Créer, lister, mettre à jour et supprimer des serveurs de noms enfants. |
| Compte et facturation | Connectez l'automatisation aux vérifications au niveau du compte. | Solde du compte et informations de compte liées aux transactions. |
| WHMCS API | Intégrez NiceNIC dans un flux de facturation WHMCS existant. | Disponibilité, enregistrement, renouvellement, transfert, détails du domaine, serveurs de noms, contacts et fonctions supplémentaires du module de bureau d'enregistrement. |
| FAQ de l'API | Résolvez les questions courantes liées aux accès, à la sécurité, aux tests et aux flux de travail. | Éligibilité, identifiants, traitement des requêtes, opérations prises en charge et conseils d'intégration. |
Flux de travail recommandé
Séquence de première intégration recommandée
Une intégration fiable en production doit valider les accès et les conditions d'achat avant de commencer à envoyer des commandes réelles de clients.
1. Authentification
Secret API + IP autorisée
Secret API + IP autorisée
→
2. Disponibilité
Test de connectivité en lecture seule
Test de connectivité en lecture seule
→
3. Tarifs
Consulter les coûts actuels au niveau du compte
Consulter les coûts actuels au niveau du compte
→
4. Solde
Confirmer les fonds pour les opérations payantes
Confirmer les fonds pour les opérations payantes
→
5. Gestion des réponses
Traiter le code + msg
Traiter le code + msg
→
6. Opérations réelles
Enregistrement / Renouvellement / Transfert
Enregistrement / Renouvellement / Transfert
Ne partez pas du principe qu'une requête API est terminée simplement parce qu'elle a été acceptée. Certaines opérations peuvent retourner un statut en attente et nécessiter encore un traitement par le registre avant que l'état final du domaine ne soit confirmé.
Comportement en production
Comprendre les réponses de succès, en attente et d'erreur
code: 0 — Réponse réussie Les exemples actuels de points de terminaison utilisent le code 0 pour indiquer des réponses traitées avec succès.
code: 201 — Commande en attente La documentation d'enregistrement et de transfert peut renvoyer le code 201 lorsqu'une commande a été soumise mais que le traitement final est toujours en attente.
code: 400 — Erreur de requête Les exemples de points de terminaison utilisent le code 400 pour les erreurs de paramètres de requête.
Comportement d'enregistrement en attente
Pour l'enregistrement de domaine, la documentation actuelle indique qu'une réponse 201 signifie que la commande a été soumise avec succès et que les frais ont été déduits, mais que l'activation définitive reste soumise à la confirmation du registre. Si le domaine ne peut pas être activé, les frais d'enregistrement sont recrédités sur le solde du compte NiceNIC sous 24 heures.
Comportement lors d'un transfert en attente
L'endpoint de transfert documente également 201 comme une commande en attente. Votre application doit donc considérer un transfert en attente comme accepté pour traitement, et non comme la preuve que le transfert est déjà terminé.
Tarifs
Consulter les tarifs avant les opérations payantes
Le point de terminaison de tarification de NiceNIC permet de récupérer les tarifs d'enregistrement, de renouvellement et de transfert pour un domaine. Les valeurs documentées pour type sont register, renew, transfer et all. La période documentée est de 1 à 10 ans, avec des exceptions possibles selon le TLD.
Les réponses de tarification d'enregistrement peuvent également renvoyer un indicateur is_premium. Utilisez le point de terminaison de tarification avant de soumettre une requête payante lorsque votre application doit connaître le coût actuel au niveau du compte.
L'accès gratuit à l'API ne modifie pas votre niveau tarifaire. Les comptes au tarif de détail appliquent la tarification des comptes au tarif de détail ; les comptes revendeurs appliquent la tarification attribuée à leur niveau revendeur actuel.
Opérations de domaines et DNS
Comprendre la différence entre serveurs de noms, enregistrements DNS et serveurs de noms enfants
| Opération | Quand l'utiliser | Fonctionnalité documentée |
|---|---|---|
| Mettre à jour les serveurs de noms | Vous souhaitez déléguer un nom de domaine à d'autres serveurs de noms faisant autorité. | L'endpoint des serveurs de noms du domaine prend en charge un serveur de noms primaire, un secondaire et des serveurs supplémentaires, la page actuelle documentant une limite de six au maximum. |
| Enregistrements DNS | Vous utilisez l'hébergement DNS de NiceNIC et devez gérer les enregistrements de zone. | Des API distinctes sont documentées pour lister, créer, mettre à jour et supprimer des enregistrements DNS. |
| Serveurs de noms enfants | Vous avez besoin d'enregistrements d'hôte / glue records tels que ns1.example.com. |
Créez, listez, mettez à jour et supprimez des serveurs de noms enfants (child nameservers). Le point de terminaison de création exige que le nom d'hôte du serveur de noms corresponde au domaine et accepte une adresse IP. |
Portefeuille et conformité
Automatisez la surveillance de portefeuille, pas seulement les commandes de domaines
L'API de noms de domaine v2 comprend également des opérations de lecture utiles après l'enregistrement. Le point de terminaison de liste des domaines prend en charge la pagination, le tri, le filtrage par statut et le filtrage par blocage, tandis que les détails du domaine renvoient les dates d'enregistrement, les dates d'expiration, les serveurs de noms et les coordonnées du contact titulaire.
Surveillance des abus et de la conformité
L'API Abus et conformité de NiceNIC permet de répertorier les domaines faisant l'objet de signalements d'abus et de renvoyer un récapitulatif détaillé lisible par machine pour un domaine spécifique. Le point de terminaison détaillé sur les abus documente six libellés de statut au niveau du domaine : Normal, Under Review, Pending ClientHold, ClientHold, Closed et ServerHold.
La réponse peut inclure l'impact actuel, l'action suivante recommandée, l'état et le calendrier de blocage, le nombre de plaintes, les dates des plaintes, les catégories, la classification de l'abus DNS, l'état des preuves ainsi que les URL signalées, le cas échéant. Cela permet aux plateformes et aux revendeurs d'afficher le statut de conformité au sein de leurs propres systèmes opérationnels au lieu de s'en remettre uniquement à un examen manuel.
API directe ou WHMCS
Choisissez le modèle d'intégration adapté à votre système
| Option | Idéal pour | Ce que fournit la documentation actuelle |
|---|---|---|
| API de noms de domaine v2 | Sites web personnalisés, plateformes SaaS, systèmes internes, flux personnalisés de facturation ou de provisionnement. | Intégration directe HTTPS + JSON pour les opérations sur les domaines, le DNS, les serveurs de noms enfants, les comptes et la conformité. |
| Module WHMCS | Hébergeurs et revendeurs qui utilisent déjà WHMCS. | Disponibilité, enregistrement, renouvellement, transfert, détails du domaine, serveurs de noms, contacts, verrouillage/déverrouillage, récupération du code EPP, journalisation des erreurs et mode test facultatif. |
La documentation WHMCS actuelle indique les prérequis suivants : WHMCS 7.0 ou version supérieure, PHP 7.0 ou version supérieure avec cURL, identifiants API NiceNIC valides et prise en charge de SSL/TLS.
Dépannage
Lorsqu'une requête API échoue
Basez-vous sur la réponse renvoyée et l'état de configuration plutôt que de relancer plusieurs fois la même opération payante.
Erreur d'authentification ou d'accès
- Confirmez le nom d'utilisateur NiceNIC et l'API Secret.
- Vérifiez que l'en-tête Authorization est présent et correctement formaté.
- Vérifiez que le secret API n'a pas été réinitialisé ou renouvelé.
- Si les restrictions d'IP sont activées, confirmez que la requête provient bien de l'IP sortante autorisée du serveur.
Erreur de paramètre de requête
- Comparez la requête avec les paramètres documentés pour le point de terminaison spécifique.
- Confirmez les valeurs requises, les formats et les noms d'actions.
- Vérifiez les périodes d'enregistrement ou les exigences relatives aux contacts spécifiques à chaque TLD, le cas échéant.
L'opération payante ne s'effectue pas immédiatement
- Lisez les champs
codeetmsgretournés. - Ne considérez pas une réponse
201en attente comme une finalisation définitive. - Confirmez le solde du compte et la tarification actuelle avant de réécouter une action payante.
Besoin de l'assistance NiceNIC
- Enregistrez l'horodatage de la requête et l'action d'API.
- Incluez le nom de domaine ou l'objet concerné, le cas échéant.
- Incluez le code et le message renvoyés.
- Ne partagez que des paramètres non confidentiels ; ne publiez jamais l'API Secret complet dans un ticket.
Étape suivante
Commencer par une requête de test sans risque
Activez l'accès API, confirmez l'authentification, effectuez une requête de disponibilité ou de tarification, et vérifiez la gestion de vos réponses avant d'activer les opérations payantes destinées aux clients.
Dernière vérification : 26 août 2026
