X
Publicat: 2026-05-26 | Actualitzat: 2026-05-26
Erro d'autenticació de l'API NiceNIC v2: causes comunes i solucions


Si la teva sol·licitud a l'API Revendedor NiceNIC v2 retona un erro d'autenticació, el problema sol provenir de les credencials API, l'encapçalament d'Autoització, la configuració de la llista blanca d'IPs, l'accés de revendedo o l'enton del servido que envia la sol·licitud.

Aquesta guia explica les causes més comunes i propociona a revendedos, proveïdos d'allotjament, desenvolupados, agències i usuaris de WHMCS una llista pràctica per solucionar problemes d'autenticació de l'API NiceNIC v2 abans d'enviar un tiquet.

Un erro d'autenticació de l'API NiceNIC v2 nomalment significa que la sol·licitud API no es pot verificar. Comença comprovant si el teu compte té accés com a revendedo, si estàs usant la contrasenya de l'API i no la del compte NiceNIC, si l'encapçalament d'Autoització està fomatat corectament i si l'adreça IP del teu servido està a la llista blanca a la configuració de l'API.

Les sol·licituds de l'API NiceNIC v2 s'han d'enviar a l'endpoint de l'API amb els encapçalaments HTTP requerits, incloent-hi l'encapçalament d'Autoització i el Content-Tipus configurat a application/json.



Què sol significar aquest erro d'autenticació
Un erro d'autenticació de l'API significa que NiceNIC no pot verificar la sol·licitud API com una sol·licitud vàlida d'un compte de revendedo autoitzat. Això no sempre vol dir que el servei API estigui caigut. En la majoia de casos, significa que una o més condicions d'accés no són corectes.
Les causes comunes inclouen:
  • Estàs utilitzant la contrasenya de l'inici de sessió del teu compte NiceNIC en lloc de la contrasenya API
  • La contrasenya API no s'ha configurat a la configuració de l'API
  • L'encapçalament d'Autoització falta o està fomatat incorectament
  • El nom d'usuari o el secret API són incorectes
  • La sol·licitud s'envia des d'una adreça IP que no està en la llista blanca
  • La IP real d'eixida del servido és diferent de l'adreça IP que has afegit
  • El teu compte no s'ha actualitzat a un nivell elegible de revendedo
  • La sol·licitud s'envia a l'endpoint equivocat
  • El Content-Tipus o el fomat JSON de la sol·licitud és incorecte
  • WHMCS utilitza credencials API obsoletes, incorectes o incompletes
La sol·licitud API ha d'enviar-se des d'una adreça IP de servido que hagi estat afegida a la configuració de la teva API. La contrasenya API ha de ser diferent de la contrasenya d'inici de sessió del teu compte NiceNIC.

Si utilitzes WHMCS, confirma que el servido WHMCS envia sol·licituds des de la mateixa adreça IP de sotida que has agregat als teus ajustos d'API de NiceNIC.


Causa 1: Estàs utilitzant la contrasenya d'inici de sessió del compte en lloc de la contrasenya API
Aquesta és una de les causes més habituals dels erros d'autenticació de l'API NiceNIC. La contrasenya d'inici de sessió del teu compte NiceNIC i la contrasenya API no haurien de ser iguals. La contrasenya API ha de configurar-se separadament a la configuració de l'API.

Com solucionar-ho?
  1. Inicia sessió al teu compte NiceNIC.
  2. Ves a la secció Revendedo.
  3. Obre Configuració de l'API.
  4. Configura una contrasenya API diferent de la contrasenya d'inici de sessió del teu compte NiceNIC.
  5. Actualitza la integració de l'API o la configuració WHMCS amb la contrasenya API corecta.
  6. Prova novament la sol·licitud API.
Per a la guia de configuració existent de l'API NiceNIC, revisa:
https://nicenic.com/suppot/API-NiceNIC-3824


Causa 2: L'encapçalament d'Autoització falta o és incorecte
L'API NiceNIC v2 requereix un encapçalament HTTP d'Autoització. El fomat documentat és: Authoization: username:api_secret
Si l'encapçalament manca, està mal escrit, codificat incorectament o enviat en un fomat erroni, la sol·licitud API pot fallar en l'autenticació.

Com solucionar-ho?
  • Confirmaa que la teva sol·licitud inclou l'encapçalament d'Autoització.
  • Confirmaa que el nom d'usuari és corecte.
  • Confirmaa que el secret API sigui la teva contrasenya API, no la del teu inici de sessió.
  • Comprova que no hi hagi espais addicionals abans o després del nom d'usuari o del secret API.
  • Confirmaa que el teu client HTTP, framewok o mòdul WHMCS no estigui eliminant l'encapçalament d'Autoització.
  • Confirmaa que el teu servido o proxy no bloquegi encapçalaments personalitzats.
Utilitza la documentació oficial de l'API v2 per al fomat de connexió actual:
https://nicenic.com/reseller/apiv2.php


Causa 3: L'adreça IP del teu servido no està a la llista blanca
La configuració de l'API NiceNIC requereix la IP autoitzada per accedir a la teva API. Si la teva sol·licitud prové d'una adreça IP que no ha estat afegida, l'autenticació pot fallar encara que el nom d'usuari i la contrasenya API siguin corectes.

Com solucionar-ho?
  1. Demana al teu desenvolupado o proveïdo d'allotjament que confirmi l'adreça IP pública de sotida usada pel teu servido.
  2. Inicia sessió al teu compte NiceNIC.
  3. Ves a Revendedo > Configuració de l'API.
  4. Afegeix la IP corecta autoitzada per accedir a la teva API.
  5. Desa la configuració.
  6. Envia una altra sol·licitud de prova des del mateix servido.

Causa 4: La teva IP real de sotida és diferent de la IP que has afegit
L'adreça IP que veus al teu panell de control d'allotjament no sempre és la mateixa que s'utilitza per a les sol·licituds d'API de sotida.
Això és especialment comú quan el teu sistema està darrere:
  • Un  tallafocs
  • Un equilibrado de càrrega
  • Un proxy
  • Una pota NAT
  • Un enton containeritzat
  • Una xarxa d'allotjament al núvol
  • Un servido WHMCS separat
Per exemple, el teu lloc web pot utilitzar una adreça IP, mentre que el servido backend o la instal·lació WHMCS envia sol·licituds API a través d'una altra adreça IP de sotida.
Com solucionar-ho?
  • Demana al teu proveïdo d'allotjament que confirmi la IP real de sotida usada per a les sol·licituds API.
  • Comprova la IP de sotida del servido que envia la sol·licitud API, no només la IP del lloc web.
  • Si WHMCS està instal·lat en un servido separat, afegeix a la llista blanca la IP de sotida del servido WHMCS.
  • Si la teva infraestructura té múltiples IPs de sotida, confirma quina IP s'utilitza realment per la sol·licitud API.
  • Actualitza la configuració de l'API NiceNIC amb la IP corecta.

Causa 5: El teu compte encara no és elegible per a l'accés a l'API
L'accés a l'API NiceNIC està dissenyat per a usuaris revendedos elegibles. Si el teu compte no ha estat actualitzat a un nivell de revendedo, o si no s'ha activat l'accés de revendedo per al teu compte, pot ser que la configuració de l'API no estigui disponible o que l'autenticació API falli.

Com solucionar-ho?
  • Confirmaa que el teu compte NiceNIC s'ha actualitzat a un nivell de revendedo.
  • Comprova si la Configuració de l'API està disponible a la navegació de Revendedo.
  • Revisa el programa de revendedos i la infomació sobre nivells de revendedo.
  • Contactea amb el supot de NiceNIC si la teva actualització a revendedo es va completar però encara no tens accés a l'API.
Pàgines relacionades:
https://nicenic.com/reseller/
https://nicenic.com/suppot/API-Revendedor-Nivell-3823


Causa 6: La teva sol·licitud s'envia a l'endpoint equivocat
Les sol·licituds de l'API NiceNIC v2 s'han d'enviar a l'endpoint documentat de l'API v2.

Si el teu codi utilitza un endpoint antic, una URL incorecta, una barra manca o una versió de l'API diferent, l'autenticació o la gestió de sol·licituds poden fallar.
Com solucionar-ho?
  • Confirmaa que la teva integració apunta a https://api.NiceNIC/v2/.
  • Comprova si encara hi ha algun endpoint de staging, sibox o antic configurat al teu codi.
  • Comprova si WHMCS o el teu mòdul personalitzat utilitza l'endpoint actual.
  • Revisa els registres del servido per confirmar l'URL exacta sol·licitada.

Causa 7: Content-Tipus o fomat JSON incorectes
L'API NiceNIC v2 tona respostes JSON i espera que les sol·licituds API segueixin el fomat documentat.
La teva sol·licitud ha d'incloure:
Content-Tipus: application/json

Si el cos de la sol·licitud no és JSON vàlid, falten paràmetres requerits o el Content-Tipus no està configurat corectament, la sol·licitud API pot fallar abans que s'executi l'acció desitjada.
Com solucionar-ho?
  • Configura el Content-Tipus a application/json.
  • Assegura't que el cos de la sol·licitud sigui JSON vàlid.
  • Confirmaa que s'incloguin els paràmetres requerits.
  • Confirmaa que els noms dels paràmetres coincideixin amb la documentació de l'API.
  • Comprova si el teu client HTTP canvia el fomat del cos de la sol·licitud.
  • Registra el fomat de la sol·licitud durant les proves, però mai no registris les credencials API completes en text pla.

Causa 8: Les credencials de l'API WHMCS no estan configurades corectament
Si utilitzes WHMCS, un erro d'autenticació pot provenir de la configuració del mòdul registrado de WHMCS més que del teu codi API personalitzat.

Les causes comunes relacionades amb WHMCS inclouen:
  • El mòdul WHMCS utilitza la contrasenya API incorecta
  • La IP de sotida del servido WHMCS no està a la llista blanca
  • El nom d'usuari o el valo del compte revendedo s'ha introduït incorectament
  • La instal·lació de WHMCS utilitza detalls de configuració obsolets
  • El cron o l'enton del mòdul WHMCS envia sol·licituds des d'un servido diferent
  • Els paràmetres del mòdul WHMCS es van canviar però no es van desar corectament
Com solucionar-ho
  1. Obre la configuració del mòdul registrado de WHMCS.
  2. Confirmaa el nom d'usuari d'API NiceNIC i la contrasenya API.
  3. Confirmaa que la IP de sotida del servido WHMCS està a la llista blanca a la configuració de l'API NiceNIC.
  4. Comprova si WHMCS utilitza les dades actuals d'integració API de NiceNIC.
  5. Prova una acció de baix risc com la comprovació de disponibilitat de domini abans d'habilitar comies en viu.
Revisa la pàgina d'integració NiceNIC WHMCS aquí:
https://nicenic.com/reseller/whmcs.php


Llista de comprovació pas a pas per a la solució
Utilitza aquesta llista abans d'enviar un tiquet de supot.
  1. Confirmaa que el teu compte NiceNIC té accés de revendedo.
  2. Obre configuració de l'API a la secció Revendedo.
  3. Estableix una contrasenya API diferent de la de l'inici de sessió del compte.
  4. Confirmaa que la teva integració API utilitza la contrasenya API, no la contrasenya d'inici de sessió.
  5. Confirmaa el fomat de l'encapçalament d'Autoització: username:api_secret.
  6. Confirmaa l'endpoint de la sol·licitud: https://api.NiceNIC/v2/.
  7. Confirmaa que el Content-Tipus està configurat a application/json.
  8. Confirmaa que el cos de la sol·licitud sigui JSON vàlid.
  9. Confirmaa que la IP de sotida del servido està a la llista blanca.
  10. Si utilitzes WHMCS, confirma la IP de sotida del servido WHMCS.
  11. Prova primer una acció API de baix risc.
  12. Registra la marca tempoal de la sol·licitud, l'acció, el domini, el codi de resposta i el missatge de resposta.


Què enviar al supot de NiceNIC si encara necessites ajuda
Si l'erro d'autenticació continua després d'haver completat la llista, envia un tiquet de supot amb prou infomació tècnica perquè NiceNIC pugui revisar el problema de manera eficient.

Si us plau, inclou:
El teu nom d'usuari de compte NiceNIC o identificado de compte revendedo
L'acció API que vas intentar
La marca tempoal i la zona hoària de la sol·licitud
El nom de domini utilitzat en la prova, si escau
L'adreça IP de sotida del servido utilitzada per la sol·licitud
L'endpoint API complet sol·licitat
El codi i missatge de resposta retonats per l'API
Si estàs utilitzant codi personalitzat o WHMCS
La versió de WHMCS, si WHMCS està implicat
Captures de pantalla rellevants, excloent credencials sensibles

No enviïs la contrasenya API completa, la contrasenya d'inici de sessió ni les credencials privades del servido en un tiquet de supot.
https://nicenic.com/suppot/Contacte-Us-3834


Preguntes freqüents
Per què la meva sol·licitud NiceNIC API v2 retona un erro d'autenticació?
Les causes més comunes són una contrasenya API incorecta, l'encapçalament d'Autoització faltant o incorecte, una adreça IP de servido no inclosa a la llista blanca, una IP de sotida errònia, accés de revendedo no elegible, un endpoint incorecte o una configuració WHMCS errònia.

He d'usar la contrasenya d'inici de sessió del meu compte NiceNIC per a l'autenticació API?
No. Has d'establir una contrasenya API separada a la configuració de l'API. La contrasenya API ha de ser diferent de la contrasenya d'inici de sessió del teu compte NiceNIC.

Quin encapçalament d'Autoització he d'utilitzar per a l'API NiceNIC v2?
El fomat documentat de l'encapçalament d'Autoització és username:api_secret. També has d'incloure Content-Tipus: application/json a l'encapçalament de la sol·licitud.

Per què l'API continua fallant després d'haver configurat la contrasenya corecta?
La sol·licitud pot provenir d'una adreça IP que no està a la llista blanca. Confirmaa la IP real de sotida del teu servido, instal·lació de WHMCS o aplicació backend.

WHMCS utilitza la mateixa IP de servido que el meu lloc web?
No sempre. WHMCS pot estar instal·lat en un servido diferent, darrere d'un proxy o en un enton amb una IP de sotida diferent. Confirmaa la IP de sotida real abans d'afegir-la a la configuració de l'API NiceNIC.

Pot NiceNIC solucionar erros d'autenticació causats per la configuració del meu servido?
NiceNIC pot ajudar a revisar l'accés per part del registrado, la configuració de l'API i els requisits de connexió documentats. Problemes del costat servido com nomes de tallafocs, enroutament IP de sotida, compotament del proxy, configuració del mòdul WHMCS i codi personalitzat poden haver de ser revisats pel teu desenvolupado o proveïdo d'allotjament.

Què hauria de provar primer després de solucionar el problema d'autenticació?
Comença amb una acció API de baix risc com comprovar el saldo del compte, comprovar la disponibilitat de domini, consultar preus o obtenir llista de dominis abans d'habilitar registres, renovacions o transferències en viu.
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