X
Publicat: 2026-05-25 | Actualitzat: 2026-05-25
Com començar a utilitzar NiceNIC Reseller API v2


NiceNIC Reseller API v2 ajuda els revenedos de dominis, proveïdos d’allotjament, desenvolupados i usuaris de WHMCS a automatitzar les operacions de domini a través d’una connexió directa a l’API.

Amb l’API, els revenedos NiceNIC elegibles poden connectar el seu propi lloc web, sistema de facturació, instal·lació de WHMCS o platafoma personalitzada per automatitzar fluxos de treball comuns de domini com ara comprovacions de disponibilitat de domini, registre de domini, renovació de domini, transferència de domini, actualització de servidos de noms, gestió de registres DNS, comprovació de saldo de compte i revisió de transaccions. 


Resposta ràpida
Per començar a utilitzar NiceNIC Revendedor API v2, cal que actualitzeu el vostre compte NiceNIC a un nivell de revendedo, configureu la configuració de l’API, creeu una contrasenya d’API diferent de la contrasenya d’inici de sessió del compte, afegiu a la llista blanca l’adreça IP permesa per accedir a l’API i després connecteu el vostre sistema al punt final de NiceNIC API v2.

Si utilitzeu WHMCS, també podeu connectar-vos a través de la integració de WHMCS de NiceNIC en lloc de construir manualment cada flux de treball de l’API.


Qui hauria d’utilitzar NiceNIC Reseller API v2?
NiceNIC Reseller API v2 està dissenyada per a usuaris que necessiten més que la gestió manual de dominis.
És adequada per a:
  • Revenedos de dominis que venen dominis als seus propis clients
  • Proveïdos d’allotjament que volen empaquetar el registre de domini amb plans d’allotjament
  • Agències web que gestionen molts dominis de clients
  • Desenvolupados que construeixen sistemes personalitzats de cerca o registre de dominis
  • Usuaris de WHMCS que volen operacions automàtiques de domini
  • Empreses que necessiten gestió massiva de dominis o fluxos de treball repetitius de domini
Si només registreu un o dos dominis ocasionalment, el panell de control NiceNIC pot ser suficient. Si gestioneu molts dominis o voleu que la vostra pròpia platafoma es comuniqui directament amb NiceNIC, l’API per a revendedores és el flux de treball millo.


Què podeu fer amb NiceNIC Reseller API v2?
NiceNIC Reseller API v2 pot ajudar a automatitzar parts impotants del cicle de vida del domini.
Depenent de l’estat del vostre compte, permisos d’API, extensió del domini, regles de registre i supot de producte disponible, les funcions de l’API poden incloure:
  • Comprovar la disponibilitat del domini
  • Registrador noms de domini
  • Renovar dominis existents
  • Transferir dominis amb codis EPP
  • Llistar dominis al vostre compte
  • Obtenir detalls del domini
  • Actualitzar servidos de noms
  • Actualitzar la infomació de contacte del domini
  • Comprovar el preu del domini
  • Gestionar registres DNS
  • Crear i gestionar servidos de noms secundaris
  • Comprovar saldo del compte
  • Revisar transaccions del compte
  • Connectar amb fluxos de treball WHMCS
Algunes accions poden dependre de les regles del registre, els requisits del TLD, l’estat del domini, la verificació del compte, el saldo de pagament o requisits addicionals de documentació. Sempre verifiqueu la resposta de l’API i la regla del domini relacionada abans de suposar que cada extensió es compota igual.


Abans de començar
Abans de connectar-vos a NiceNIC Reseller API v2, prepareu el següent:
  • Un compte NiceNIC registrat
  • Un compte de revendedo actualitzat o accés a revendedo elegible
  • Suficient saldo al compte per a operacions de domini de pagament
  • El vostre nom d’usuari API i contrasenya d’API
  • Adreça IP del servido que enviarà les sol·licituds a l’API
  • Un desenvolupado, administrado de WHMCS o membre de l’equip tècnic per completar la integració
  • Un flux de treball de prova abans d’utilitzar l’API per a comies en viu de clients
Per a una millo seguretat, no utilitzeu la vostra contrasenya d’inici de sessió del compte com a contrasenya d’API. La vostra contrasenya d’API ha de ser diferent i usada només per a l’autenticació API.


Pas 1: Actualitzeu el vostre compte a un nivell de revendedo
L’accés a l’API està destinat als usuaris revendedos de NiceNIC. Si el vostre compte encara no ha estat actualitzat, inicieu sessió al vostre compte NiceNIC i reviseu les opcions de actualització de revendedo.
Un compte de revendedo és útil si voleu:
  • Accedir a preus de domini a nivell de revendedo
  • Gestionar més dominis sota un mateix compte
  • Utilitzar automatització API per a les operacions de domini
  • Connectar WHMCS o un altre sistema de facturació
  • Generar ingressos recurrents de domini de la vostra pròpia base de clients
Un cop completada l’actualització del revendedo, podeu continuar amb el procés de configuració de l’API.

Preparat per automatitzar els serveis de domini?
Actualitzeu a un compte de revendedo NiceNIC i connecteu el registre de domini, renovació, transferència, DNS i fluxos de treball WHMCS a través de Reseller API v2.



Pas 2: Obriu la configuració de l’API al vostre compte NiceNIC
Un cop el vostre compte estigui actualitzat a nivell de revendedo, inicieu sessió al vostre compte NiceNIC i aneu a la secció Revendedo.
Després trobeu l’àrea de configuració de l’API. És aquí on configureu l’accés a l’API per al vostre compte de revendedo.
En aquesta àrea, nomalment heu de completar dues configuracions clau:
  • Configureu la contrasenya d’API
  • Afegiu l’adreça IP permesa per accedir a l’API
Si no podeu veure la configuració de l’API al vostre compte, comproveu si l’actualització del revendedo s’ha completat o contacteu amb el supot de NiceNIC per a una revisió del compte.


Pas 3: Configureu una contrasenya d’API separada
La vostra contrasenya d’API ha de ser diferent de la contrasenya d’inici de sessió del vostre compte NiceNIC. Això és impotant tant per a la seguretat com per a la resolució de problemes. Si utilitzeu la contrasenya incorecta o la contrasenya d’inici de sessió en comptes de la contrasenya d’API, l’autenticació pot fallar.
Pràctica recomanada:
  • Utilitzeu una contrasenya d’API segura
  • No reutilitzeu la contrasenya d’inici de sessió
  • Emmagatzemeu les credencials de l’API de manera segura
  • No envieu credencials de l’API per xats insegurs o tiquets públics
  • Canvieu les credencials quan un desenvolupado, proveïdo o antic empleat ja no necessiti accés


Pas 4: Afegiu a la llista blanca l’adreça IP del vostre servido
L’accés a l’API de NiceNIC requereix l’adreça IP que enviarà les sol·licituds a l’API. Normalment és l’adreça IP pública del vostre servido, instal·lació de WHMCS, sistema de facturació o backend d’aplicació.

Abans de desar la configuració de l’API, confirmeu l’adreça IP d’eixida corecta amb el vostre desenvolupado o proveïdo d’allotjament. Si s’afegeix una adreça IP errònia, la vostra sol·licitud d’API pot fallar encara que el nom d’usuari i la contrasenya d’API siguin corectes.

Els problemes comuns relacionats amb IP inclouen:
  • L’adreça IP del servido del lloc web és diferent de l’adreça IP d’eixida de la sol·licitud a l’API
  • WHMCS està allotjat darrere d’un tallafocs, proxy o passarel·la NAT
  • El proveïdo d’allotjament ha canviat l’adreça IP del servido
  • Diversos servidos envien sol·licituds a l’API però només una adreça IP està a la llista blanca
  • Un servido de desenvolupament funciona, però el servido de producció no està a la llista blanca

Pas 5: Connecteu-vos al punt final NiceNIC API v2
Un cop la vostra contrasenya d’API i la llista blanca d’IP estiguin configurades, el vostre sistema pot enviar sol·licituds al punt final de NiceNIC API v2. L’API utilitza sol·licituds HTTP i retona respostes JSON. La vostra sol·licitud ha d’incloure els encapçalaments d’autoització i tipus de contingut necessaris.

El cos exacte de la sol·licitud depèn de l’acció API que voleu dur a terme. Per exemple, comprovar la disponibilitat del domini, registrar un domini, renovar un domini, actualitzar servidos de noms o comprovar saldo del compte poden requerir diferents paràmetres.

Seguiu sempre la documentació més recent de NiceNIC API v2 quan construïu o actualitzeu la vostra integració.

Necessiteu la documentació tècnica?
Utilitzeu la documentació oficial de NiceNIC Reseller API v2 per revisar l’autenticació, codis de resposta, accions de domini, accions DNS, accions de facturació i supot WHMCS.


Pas 6: Proveu una acció d’API segura primer
Abans de realitzar accions de pagament o dirigides als clients, proveu primer una acció d’API de baix risc.

Proves recomanades inicials:
  • Comprovar saldo del compte
  • Comprovar disponibilitat del domini
  • Obtenir preus de domini
  • Llistar dominis
Eviteu començar amb el registre en viu o la transferència de domini fins que confirmeu que l’autenticació, la llista blanca d’IP, el fomat de la sol·licitud i el maneig de resposta funcionen corectament.

El vostre desenvolupado hauria de registrar la següent infomació durant les proves:
  • Marca tempoal de la sol·licitud
  • Acció de l’API
  • Nom de domini o objecte usat en la prova
  • Paràmetres de la sol·licitud, excepte credencials sensibles
  • Codi de resposta
  • Missatge de resposta
  • Qualsevol erro retonat per l’API
No registreu les credencials completes de l’API en text pla.


Pas 7: Connecteu WHMCS si useu facturació WHMCS
Si la vostra empresa utilitza WHMCS, potser no cal que construïu cada flux de treball des de zero.

NiceNIC propociona integració WHMCS per a operacions de registre de dominis. Això pot ajudar a automatitzar fluxos de treball comuns de revendedo com la comprovació de disponibilitat, registre, renovació, transferència i recuperació d’infomació del domini.

La integració WHMCS és especialment útil per a:
  • Empreses d’allotjament que venen dominis amb paquets d’allotjament
  • Revendedos que necessiten facturació automatitzada al client
  • Agències que gestionen comies de domini per a múltiples clients
  • Empreses que volen automatització de renovació i fluxos de treball de comies per a clients
Abans d’habilitar l’automatització en producció, proveu acuradament la configuració del mòdul WHMCS. Confirmaeu la configuració del mòdul de registrado, credencials d’API, adreça IP a la llista blanca, preus del domini, disponibilitat de TLD i compotament de renovació.

Utilitzant WHMCS?
Connecteu WHMCS amb NiceNIC per automatitzar registres de domini, renovacions, transferències i gestió.



Problemes comuns de configuració i com solucionar-los
1. Erro d’autenticació
Un erro d’autenticació nomalment significa que les credencials API o la configuració d’accés no són corectes.
Comproveu el següent:
  • Confirmaeu que el vostre compte té accés de revendedo
  • Confirmaeu que utilitzeu la contrasenya d’API, no la contrasenya d’inici de sessió del compte
  • Comproveu que la contrasenya de l’API s’hagi introduït corectament
  • Confirmaeu que la vostra sol·licitud inclou l’encapçalament d’Autenticació
  • Confirmaeu que l’adreça IP del vostre servido està a la llista blanca a la configuració de l’API
  • Comproveu si la vostra sol·licitud s’està enviant des d’una adreça IP d’eixida diferent

2. IP no permesa o connexió fallida
Si la vostra adreça IP no està permesa, la sol·licitud API pot fallar abans que es processi l’acció.

Demaneu al vostre proveïdo d’allotjament o administrado de servido que confirmi la IP real d’eixida usada per a les sol·licituds API. A continuació, actualitzeu la configuració de l’API al vostre compte NiceNIC.

3. Fomat de sol·licitud invàlid
Si el cos de la sol·licitud, l’encapçalament o el fomat dels paràmetres són incorectes, l’API pot retonar un erro.
Comproveu:
  • El Content-Tipus està configurat a application/json
  • El cos de la sol·licitud és JSON vàlid
  • Els paràmetres requerits estan inclosos
  • El fomat del domini és corecte
  • El nom de l’acció coincideix amb la documentació de l’API

4. Fallida en el registre del domini
Una sol·licitud de registre de domini pot fallar per motius no relacionats amb la connexió API en si.
Possibles causes inclouen:
  • El domini ja no està disponible
  • El TLD té requisits especials de registre
  • El registre requereix documents addicionals
  • El saldo del compte no és suficient
  • La infomació de contacte del domini és incompleta o invàlida
  • El registre ha rebutjat la sol·licitud
Reviseu el missatge de resposta de l’API i comproveu si l’extensió té requisits especials del registre.

5. Fallida en la renovació o transferència
Les accions de renovació i transferència poden dependre de l’extensió del domini, l’estat del domini, les regles del registre, la línia tempoal de caducitat, el bloqueig de transferència, el codi EPP i el saldo del compte.

Per a problemes de transferència, comproveu:
  • El domini és elegible per a la transferència
  • El domini està desbloquejat en el registrado actual
  • El codi EPP és corecte
  • El domini no està bloquejat per restriccions del registre o polítiques
  • El coreu electrònic del registrant o el procés d’aprovació de la transferència s’ha completat quan s’exigeix


Què pot i què no pot fer NiceNIC
NiceNIC pot propocionar accés a l’API per al costat del registrado, eines de comptes de revendedo, documentació d’API, recursos d’integració WHMCS i supot per a operacions de domini disponibles a través de la seva platafoma.

Tanmateix, algunes accions de domini depenen de les regles del registre, polítiques d’extensió, estat de verificació, estat de pagament, estat d’abús/compliment o sistemes de tercers.

Per exemple:
  • Alguns TLD poden requerir documents especials abans del registre
  • Alguns dominis poden estar bloquejats, caducats, en verificació o restringits per la política del registre
  • Algunes sol·licituds de transferència poden requerir aprovació del registrado que perd o del contacte registrant
  • Els canvis DNS poden tardar a propagar-se globalment
  • El compotament de WHMCS també pot dependre de la vostra versió de WHMCS, configuració del mòdul, ambient del servido i configuració cron
Per això, la vostra integració sempre hauria de llegir i emmagatzemar la resposta de l’API en lloc de suposar que cada acció té èxit.


Flux de treball recomanat per a la primera integració
Si esteu construint una nova integració, utilitzeu aquesta seqüència:
  • Actualitzeu a un compte de revendedo
  • Configureu la contrasenya de l’API i la llista blanca d’IP
  • Connecteu-vos al punt final de l’API v2
  • Proveu la consulta de saldo del compte
  • Proveu la consulta de disponibilitat del domini
  • Proveu la consulta de preus
  • Proveu l’actualització dels servidos de noms en un domini intern segur
  • Reviseu els codis de resposta i el maneig d’erros
  • Connecteu WHMCS o el vostre propi sistema de facturació
  • Activeu els fluxos de treball de registre, renovació i transferència en viu només després de provar


Preguntes freqüents
1. Necessito un compte de revendedo per utilitzar NiceNIC Reseller API v2?
Sí. NiceNIC Reseller API v2 està destinada a usuaris revendedos elegibles. Si no podeu accedir a la configuració de l’API, comproveu si el vostre compte ha estat actualitzat a un nivell de revendedo.

2. Puc utilitzar la contrasenya d’inici de sessió del meu compte NiceNIC com a contrasenya de l’API?
No. Per a la seguretat i la configuració corecta, la contrasenya de l’API ha de ser diferent de la contrasenya d’inici de sessió del vostre compte.

3. Per què la meva sol·licitud API retona un erro d’autenticació?
Els erros d’autenticació es causen sovint per una contrasenya d’API errònia, falta de l’encapçalament d’Autenticació, nom d’usuari incorecte, adreça IP no a la llista blanca o una sol·licitud enviada des d’una IP d’eixida diferent.

4. Puc utilitzar NiceNIC API v2 amb WHMCS?
Sí. NiceNIC propociona integració WHMCS per a operacions de registrado de domini com la comprovació de disponibilitat, registre, renovació, transferència i recuperació d’infomació de domini.

5. Puc registrar cada extensió de domini mitjançant l’API?
No sempre. El registre de dominis depèn de la disponibilitat del TLD, regles del registre, saldo del compte, requisits de verificació i restriccions específiques d’extensió. Alguns TLD poden requerir documents addicionals o revisió manual.

6. Què hauria de provar abans de posar-ho en funcionament?
Comenceu amb accions de baix risc com la consulta de saldo del compte, comprovació de disponibilitat de domini, consulta de preus i llistat de dominis. No activeu comies en viu dels clients fins que s’hagi confirmat que l’autenticació, la llista blanca d’IP, el fomat de sol·licitud, el maneig de resposta i la lògica de facturació funcionen corectament.


Comenceu a automatitzar serveis de domini amb NiceNIC
NiceNIC Reseller API v2 ofereix als revendedos, proveïdos d’allotjament, desenvolupados i usuaris de WHMCS una manera directa d’automatitzar la cerca, registre, renovació, transferència, DNS i fluxos de treball del compte de domini.

Necessites ajuda? Sempre estem aquí per a tu. Enviar una incidència
Drets d'autor © 2006-2026 NICENIC INTERNATIONAL GROUP CO., LIMITED Tots els drets reservats