Aperçu de l'API
Documentation et démarrage rapide de l'API de domaines NiceNIC v2
L'API de domaines NiceNIC v2 est disponible à la fois pour les comptes de marché et les comptes revendeur. Utilisez cet aperçu pour configurer l'accès, valider votre première requête, comprendre le modèle de réponse de l'API et accéder directement à la bonne section dans la navigation de gauche.
L'accès à l'API et la tarification revendeur sont distincts.
Compte Market : accès à l'API avec la tarification du compte Market.
Compte Revendeur : accès à l'API avec la tarification attribuée au niveau de revendeur actuel.
Comparer les niveaux et tarifs revendeur →
Compte Market : accès à l'API avec la tarification du compte Market.
Compte Revendeur : accès à l'API avec la tarification attribuée au niveau de revendeur actuel.
Comparer les niveaux et tarifs revendeur →
Endpoint 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 en cas de succès
{ "code": 0, "msg": "success", "data": {} }
Bac à sable de l'API
Testez votre intégration avant de passer en production
Utilisez le bac à sable API NiceNIC pour tester votre intégration à l'API de domaine avant de passer en production. Validez l'authentification, les requêtes API, le traitement des réponses et le flux de travail de votre application dans un environnement de test dédié.
Idéal pour les revendeurs, les fournisseurs d'hébergement, les développeurs et les plateformes qui préparent une intégration API.
Démarrage rapide
Effectuez votre premier appel API en 4 étapes
Commencez par une requête en lecture seule avant d'activer les enregistrements, renouvellements ou transferts en production. Cela vous permet de valider l'authentification, le format des requêtes et le traitement des réponses sans passer de commande payante.
1
Activer l'accès API
Ouvrir les paramètres API, créer ou récupérer votre secret d'API, et configurer les adresses IP de serveurs autorisés le cas échéant.
2
Confirmer l'authentification
Utilisez HTTPS avec l'en-tête Authorization au format username:api_secret.
3
Lancez un test en toute sécurité
Commencez par la disponibilité des domaines, les prix, le solde du compte ou la liste des domaines.
4
Traiter la réponse
Lisez et stockez le code et le msg renvoyés avant d'activer les actions de production payantes.
Première requête recommandée : disponibilité de domaine
Le point de terminaison de disponibilité prend en charge plusieurs domaines dans une seule requête en séparant les noms de domaine 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
La vue d'ensemble ci-dessous reflète la navigation de gauche. Utilisez-la pour identifier le flux de travail approprié, puis ouvrez la page de point de terminaison dédiée pour les paramètres, les exemples de requêtes et les exemples de réponses.
| Rubrique | Utilisation | Fonctions documentées |
|---|---|---|
| Pour commencer | Connectez-vous en toute sécurité et comprenez la gestion des réponses. | Aperçu de l'API, bac à sable 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, tarification. |
| Abus et conformité | Surveillez les domaines nécessitant une attention de conformité. | Listez les domaines avec des rapports d'abus et récupérez le statut d'abus lisible par machine, le cycle de vie de mise en attente, les informations de plainte et l'action recommandée. |
| Enregistrements DNS | Gérez les enregistrements DNS hébergés par programmation. | Listez, créez, mettez à jour et supprimez des enregistrements DNS. |
| Serveurs de noms enfants | Gérez les enregistrements d'hôte / glue pour les serveurs de noms sous votre propre domaine. | Créez, listez, mettez à jour et supprimez 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. |
| API WHMCS | 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 sur l'accès, la sécurité, les tests et les flux de travail. | Éligibilité, identifiants, traitement des demandes, opérations prises en charge et conseils d'intégration. |
Flux de travail recommandé
Séquence recommandée pour la première intégration
Une intégration de production fiable doit valider les conditions d'accès et d'achat avant de commencer à envoyer de véritables commandes 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. Tarification
Interroger le coût actuel au niveau du compte
Interroger le coût actuel au niveau du compte
→
4. Solde
Confirmer les fonds pour les actions payantes
Confirmer les fonds pour les actions payantes
→
5. Gestion des réponses
Traiter le code + msg
Traiter le code + msg
→
6. Opérations en direct
Enregistrer / Renouveler / Transférer
Enregistrer / Renouveler / Transférer
Ne supposez pas qu'une requête API est terminée simplement parce qu'elle a été acceptée. Certaines opérations peuvent renvoyer un statut en attente et nécessiter encore un traitement par le registre avant que l'état final du domaine 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 d'endpoint actuels utilisent le code 0 pour les réponses terminées avec succès.
code: 201 — Commande en attente La documentation sur l'enregistrement et le transfert peut renvoyer le code 201 lorsqu'une commande a été soumise mais que le traitement final est encore en attente.
code: 400 — Erreur de requête Les exemples d'endpoint utilisent le code 400 pour les erreurs de paramètres de requête.
Comportement en attente d'enregistrement
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 l'activation finale reste soumise à la confirmation du bureau d'enregistrement. Si le domaine ne peut pas être activé, les frais d'enregistrement sont remboursés sur le solde du compte NiceNIC sous 24 heures.
Comportement des transferts en attente
Le point de terminaison de transfert documente également le code 201 comme commande en attente. Votre application doit donc traiter 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 d'accès aux tarifs de NiceNIC permet de récupérer les tarifs d'enregistrement, de renouvellement et de transfert d'un domaine. Les valeurs de type documentées 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 relatives aux tarifs d'enregistrement peuvent également renvoyer un indicateur is_premium. Utilisez le point d'accès aux tarifs avant d'envoyer une demande 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 Market utilisent la tarification des comptes Market ; les comptes revendeur utilisent la tarification attribuée à leur niveau de revendeur actuel.
Opérations de domaine et DNS
Comprendre la différence entre les serveurs de noms, les enregistrements DNS et les serveurs de noms enfants
| Opération | Quand l'utiliser | Capacité documentée |
|---|---|---|
| Mettre à jour les serveurs de noms | Vous souhaitez déléguer un domaine à différents serveurs de noms faisant autorité. | Le point de terminaison des serveurs de noms du domaine prend en charge un serveur de noms principal, secondaire et supplémentaire, la page actuelle documentant une limite de six au maximum. |
| Enregistrements DNS | Vous utilisez l'hébergement DNS NiceNIC et devez gérer les enregistrements de zone. | Des API distinctes sont documentées pour lister, créer, mettre à jour et supprimer les enregistrements DNS. |
| Serveurs de noms enfants | Vous avez besoin d'enregistrements d'hôte / de colle tels que ns1.example.com. |
Créer, lister, mettre à jour et supprimer des serveurs de noms enfants. 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 votre portefeuille, pas seulement vos commandes de domaines
L'API Domain v2 inclut également des opérations de lecture utiles après l'enregistrement. Le point de terminaison List Domains prend en charge la pagination, le tri, le filtrage par statut et le filtrage par retenue, tandis que Get Domain Details renvoie les dates d'enregistrement, les dates d'expiration, les serveurs de noms et les informations de contact du titulaire.
Surveillance des abus et de la conformité
L'API Abuse & Compliance de NiceNIC peut lister les domaines avec des rapports d'abus et renvoyer un résumé détaillé lisible par machine pour un domaine spécifique. L'endpoint d'abus détaillé documente six expressions de statut au niveau du domaine : Normal, En cours d'examen, ClientHold en attente, ClientHold, Fermé et ServerHold.
La réponse peut inclure l'impact actuel, l'action recommandée suivante, l'état de blocage et la chronologie, le nombre de plaintes, les dates de plaintes, les catégories, la classification des abus DNS, le statut des preuves et les URL signalées le cas échéant. Cela permet aux plateformes et aux revendeurs d'afficher l'état de conformité dans leurs propres systèmes opérationnels plutôt que de compter uniquement sur un examen manuel.
API direct ou WHMCS
Choisissez le modèle d'intégration adapté à votre système
| Option | Idéal pour | Ce que fournit la documentation actuelle |
|---|---|---|
| Domain API v2 | Sites web personnalisés, plateformes SaaS, systèmes internes, workflows personnalisés de facturation ou de provisionnement. | Intégration directe HTTPS + JSON pour les opérations de domaine, DNS, serveurs de noms enfants, compte et conformité. |
| Module WHMCS | Hébergeurs et revendeurs utilisant déjà WHMCS. | Disponibilité, enregistrement, renouvellement, transfert, détails du domaine, serveurs de noms, contacts, verrouillage/déverrouillage, récupération EPP, journalisation des erreurs et mode test optionnel. |
La documentation WHMCS actuelle indique comme exigences WHMCS 7.0 ou supérieur, PHP 7.0 ou supérieur avec cURL, des identifiants API NiceNIC valides et la prise en charge SSL/TLS.
Dépannage
Quand une requête API échoue
Commencez par analyser la réponse renvoyée et l'état de la configuration plutôt que de réessayer la même action payante à plusieurs reprises.
Erreur d'authentification ou d'accès
- Vérifiez le nom d'utilisateur NiceNIC et le secret API.
- 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 IP sont activées, vérifiez que la requête provient de l'adresse IP sortante autorisée du serveur.
Erreur de paramètre de requête
- Comparez la requête avec les paramètres documentés du point de terminaison concerné.
- Vérifiez les valeurs requises, les formats et les noms d'action.
- Vérifiez les périodes d'enregistrement ou les exigences de contact spécifiques au TLD, le cas échéant.
Une opération payante ne se termine pas immédiatement
- Lisez le
codeet lemsgrenvoyés. - Ne considérez pas une réponse en attente
201comme une finalisation. - Vérifiez le solde du compte et les tarifs en vigueur avant de réessayer une action payante.
Besoin d'assistance NiceNIC
- Enregistrez l'horodatage de la demande et l'action de l'API.
- Indiquez le nom de domaine ou l'objet concerné, le cas échéant.
- Incluez le code et le message renvoyés.
- Partagez uniquement les paramètres non sensibles ; ne divulguez jamais l'intégralité de la clé API dans un ticket.
Prochaine étape
Commencez par une demande de test sécurisée
Activez l'accès à l'API, confirmez l'authentification, lancez une demande 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
