X
Publicat: 2026-05-27 | Actualitzat: 2026-05-27
Erros de Fomat de Sol·licitud de l'API NiceNIC v2: Punt Final, Capçaleres, JSON i Paràmetres

Si la vostra sol·licitud a l'API NiceNIC Revendedor v2 arriba a l'API però no funciona com s'esperava, el problema pot no ser l'autenticació. Pot ser un problema de fomat de la sol·licitud.
Aquesta guia ajuda als revendedos de dominis, proveïdos d'allotjament, desenvolupados, agències i usuaris de WHMCS a resoldre problemes comuns de fomat de sol·licitud de l'API NiceNIC v2, incloent-hi erros de punt final, capçaleres que falten, tipus de contingut incorecte, JSON invàlid, paràmetres que manquen, fomat de domini invàlid, requisits específics de TLD i problemes de configuració del mòdul WHMCS.

Els erros de fomat de sol·licitud de l'API NiceNIC v2 solen ser causats per un punt final incorecte, capçaleres que falten o són incorectes, tipus de contingut erroni, JSON invàlid, paràmetres obligatois que falten, fomat de domini invàlid, desajust entre l'acció de l'API i els paràmetres, requisits específics de registre per a TLD o configuracions del mòdul WHMCS que no coincideixen amb la sol·licitud de l'API.

Comenceu confirmant el punt final de l'API, les capçaleres requerides, el fomat JSON, els paràmetres requerits i l'acció exacta de l'API que esteu utilitzant. Si feu servir WHMCS, també comproveu la configuració del mòdul WHMCS, les credencials de l'API, el mode de prova, l'enton PHP/cURL i la configuració de sotida del servido.



Què Sol Voler Dir Aquest Tipus d'Erro de l'API
Un problema de fomat de sol·licitud significa que la vostra sol·licitud API pot estar arribant al punt final de l'API NiceNIC, però la sol·licitud no es pot processar corectament perquè alguna cosa en l'estructura de la sol·licitud, capçaleres, cos, paràmetres, dades del domini o configuració del mòdul no és vàlida per a l'acció que intenteu realitzar.

Aquest tipus de problema és diferent d'un erro pur d'autenticació. Els erros d'autenticació nomalment impliquen la contrasenya de l'API, la capçalera d'Autoització, l'accés del revendedo o la llista blanca d'IP. Els erros de fomat de sol·licitud solen implicar com es construeix la sol·licitud després que l'accés ja està configurat.

Les causes comunes d'erros de fomat de sol·licitud inclouen:
  • El punt final de l'API és incorecte.
  • Falten capçaleres necessàries o són incorectes.
  • El Content-Tipus no està fixat a application/json.
  • El cos de la sol·licitud no és un JSON vàlid.
  • Falten paràmetres obligatòries.
  • El fomat del nom de domini és invàlid.
  • L'acció de l'API i els paràmetres no coresponen.
  • El TLD té requisits específics de registre.
  • El saldo del compte, l'estat del domini o les nomes del registre impedeixen l'acció sol·licitada.
  • La configuració del mòdul WHMCS no coincideix amb la sol·licitud de l'API.


Causa 1: El Punt Final de l'API És Incorecte
Les sol·licituds de l'API NiceNIC v2 s'han d'enviar al punt final documentat de l'API v2:
https://api.NiceNIC/v2/
Si el vostre codi utilitza un punt final antic, un punt final mal escrit, un protocol erroni, un camí perdut o una versió diferent de l'API, la sol·licitud pot fallar abans que s'executi l'acció anteriorista.
Com solucionar-ho
  • Confirmaeu que la vostra sol·licitud s'envia a https://api.NiceNIC/v2/.
  • Comproveu possibles erros tipogràfics en el domini, el protocol o el camí.
  • Confirmaeu que l'enton de producció no utilitza encara un punt final antic de l'API.
  • Comproveu si el vostre mòdul WHMCS, mòdul de registrado personalitzat o configuració del backend conté una URL antiga codificada fixament.
  • Reviseu els registres del servido per confirmar la URL exacta sol·licitada per la vostra aplicació.

Utilitzeu la documentació actual de l'API NiceNIC v2 aquí: https://nicenic.com/reseller/apiv2.php

Causa 2: Falta o Errònia Capçalera Necessària
Les sol·licituds de l'API NiceNIC v2 requereixen les capçaleres HTTP corectes. Si falta la capçalera d'Autoització, la capçalera Host o la capçalera Content-Tipus, està alterada o està bloquejada, la sol·licitud pot fallar.
El fomat de capçalera documentat és:
Host: api.NiceNIC
Authoization: username:api_secret
Content-Tipus: application/json

Com solucionar-ho
  • Confirmaeu que la vostra sol·licitud inclou la capçalera d'Autoització.
  • Confirmaeu que el valo d'Autoització segueix el fomat documentat username:api_secret.
  • Confirmaeu que el secret d'API és la vostra contrasenya d'API, no la contrasenya de l'inici de sessió del compte NiceNIC.
  • Comproveu que Content-Tipus sigui exactament application/json.
  • Confirmaeu que el vostre client HTTP, framewok, proxy, tallafocs o mòdul WHMCS no està eliminant ni reescrivint capçaleres.
  • Elimineu espais innecessaris, salts de línia o caràcters ocults dels valos de les capçaleres.

Causa 3: Content-Tipus No És application/json
L'API NiceNIC v2 espera un fomat de sol·licitud JSON. Si el vostre codi envia dades com a fom-data, text/plain, x-www-fom-urlencoded o un altre fomat, l'API pot no llegir corectament la sol·licitud.
Com solucionar-ho
  • Establiu Content-Tipus a application/json.
  • Confirmaeu que el vostre client HTTP envia realment JSON, no només etiqueta la sol·licitud com a JSON.
  • Comproveu si el cos de la sol·licitud està sent convertit pel vostre framewok abans d'enviar-lo.
  • Si utilitzeu PHP, confirmeu que el cos JSON està codificat corectament abans d'enviar la sol·licitud.
  • Si utilitzeu WHMCS, confirmeu que la configuració del mòdul coincideix amb els requisits d'integració que admet NiceNIC.

Causa 4: El Cos de la Sol·licitud No És un JSON Vàlid
Una sol·licitud pot fallar si el cos no és un JSON vàlid. Això sovint passa quan el codi construeix el cos manualment en comptes d'utilitzar un codificado JSON.
Problemes comuns JSON inclouen:
  • Cometes que falten
  • Comes extres
  • Anidament incorecte d'objectes o arrays
  • Caràcters no escapats
  • Caràcters UTF-8 invàlids
  • Enviar un cos buit per a una acció que requereix paràmetres
Com solucionar-ho
  • Valideu el cos JSON abans d'enviar la sol·licitud.
  • Utilitzeu el codificado JSON del vostre llenguatge de programació en lloc de construir cadenes JSON manualment.
  • Confirmaeu que el conjunt de caràcters és UTF-8.
  • registreu el cos de la sol·licitud durant la prova, però elimineu valos sensibles abans de compartir els registres.
  • Proveu amb una acció senzilla de baix risc abans de provar accions de domini de pagament.

Causa 5: Falten Paràmetres Necessaris
Diferents accions de l'API requereixen diferents paràmetres. Una sol·licitud que funciona per a una acció no sempre es pot reutilitzar per a una altra acció.
Per exemple, comprovar la disponibilitat del domini, registrar un domini, renovar un domini, transferir un domini, actualitzar els servidos de noms, actualitzar contactes, gestionar registres DNS i comprovar el saldo del compte poden requerir cadascun camps diferents.
Com solucionar-ho
  • Obriu la secció exacta de la documentació de l'API de l'acció que utilitzeu.
  • Compareu el cos de la vostra sol·licitud amb els paràmetres requerits.
  • No doneu per suposat que el registre, la renovació, la transferència i les actualitzacions DNS utilitzen el mateix conjunt de paràmetres.
  • Confirmaeu si el TLD requereix camps addicionals o atributs ampliats.
  • Confirmaeu si l'acció requereix infomació de contacte, servidos de noms, codi d'autenticació, any, dades DNS o altres camps específics de l'acció.

Causa 6: Fomat de Domini Invàlid
Moltes sol·licituds d'API de domini requereixen el nom de domini en si, no una URL completa.
Exemples invàlids poden incloure:
  • https://example.com
  • http://example.com
  • example.com/path
  • example.com?query=value
  • example.com amb espais afegits
  • example..com
  • noms de domini que contenen caràcters no admesos
El fomat vàlid nomalment significa el nom de domini simple, com ara:
example.com
Com solucionar-ho
  • Elimineu http:// i https:// dels valos del domini.
  • Elimineu camins, cadenes de consulta, fragments i espais finals.
  • Normalitzeu la gestió de majúscules i minúscules a la vostra aplicació.
  • Valideu el fomat de domini abans d'enviar la sol·licitud de l'API.
  • Per a IDN o caràcters especials, confirmeu com s'ha d'codificar el domini abans d'enviar la sol·licitud.

Causa 7: L'Acció API i els Paràmetres No Coresponen
Una acció API ha de corespondre amb els paràmetres enviats. Si truqueu a una acció però envieu paràmetres destinats a una altra acció, la sol·licitud pot fallar o retonar una resposta inesperada.
Exemples de lògica de sol·licitud desajustada inclouen:
  • Enviar paràmetres de registre a una acció de comprovació de disponibilitat del domini
  • Enviar paràmetres de transferència sense el codi d'autoització de transferència necessari quan es demana
  • Enviar camps de registre DNS a una acció d'actualització de servido de noms
  • Enviar camps d'actualització de contacte a una acció de renovació
  • Utilitzar una acció del mòdul WHMCS que no coincideix amb l'operació que s'està provant
Com solucionar-ho
  • Comproveu el nom de l'acció o ruta de l'API que utilitzeu.
  • Reviseu la secció exacta de la documentació per a aquesta acció.
  • Compareu els paràmetres obligats amb el cos de la sol·licitud.
  • Proveu una acció alhoa.
  • No combineu la lògica de comprovació de disponibilitat, registre, actualització DNS i renovació en una plantilla de sol·licitud no verificada.

Causa 8: El TLD Té Requisits Especials de Registre
Algunes extensions de domini tenen regles especials de registre. Una sol·licitud API tècnicament vàlida pot fallar si el registre requereix infomació addicional, camps especials de contacte, documents, presència local o revisió manual.
Això és especialment impotant per a ccTLDs, TLDs restringits i extensions amb regles especials de registre o renovació.
Com solucionar-ho
  • Comproveu si l'extensió de domini té requisits especials de registre.
  • Confirmaeu si es requereix presència local, documents, atributs ampliats o dades especials de contacte.
  • Comproveu si l'acció de domini està supotada per a aquell TLD a través d'automatització.
  • No doneu per suposat que cada TLD es compota com el .com.
  • Si la resposta de l'API indica un problema relacionat amb el registre o l'extensió, reviseu la noma del TLD abans de tonar a provar repetidament.
Podeu revisar els preus i opcions d'extensions de domini aquí: https://nicenic.com/domini/prices.php

Causa 9: La Configuració del Mòdul WHMCS No Coincideix Amb la Sol·licitud de l'API
Si utilitzeu WHMCS, la sol·licitud pot ser generada pel mòdul WHMCS en lloc del vostre codi personalitzat. En aquest cas, el problema pot provenir de la configuració del mòdul, les credencials de l'API, el mode de prova, el supot PHP/cURL, el supot SSL/TLS o l'enton del servido WHMCS.

Problemes comuns relacionats amb sol·licituds WHMCS inclouen:
  • El mòdul WHMCS té credencials d'API incorectes.
  • La contrasenya de l'API es va canviar a NiceNIC però no s'ha actualitzat a WHMCS.
  • El mode de prova està activat o desactivat incorectament.
  • El servido WHMCS no compleix les condicions requerides de PHP o cURL.
  • WHMCS envia sol·licituds des d'un servido diferent del que s'esperava.
  • El preu del domini o la configuració del TLD a WHMCS no coincideix amb l'acció del domini.
  • L'automatització WHMCS està executant una acció de renovació, transferència o registre amb dades de client incompletes.
Com solucionar-ho
  • Obriu la configuració del mòdul de registrado NiceNIC a WHMCS.
  • Confirmaeu el nom d'usuari i el secret de l'API.
  • Comproveu si el mode de prova està activat només quan voleu provar.
  • Confirmaeu que el servido WHMCS supota l'enton PHP i cURL requerit.
  • Confirmaeu que el supot SSL/TLS està disponible per a la comunicació segura de l'API.
  • Proveu la disponibilitat del domini abans d'habilitar els fluxos de treball d'enregistrament, renovació o transferència en viu.
  • Reviseu els registres del mòdul WHMCS i les respostes de l'API NiceNIC conjuntament.
Reviseu la pàgina d'integració WHMCS de NiceNIC aquí: https://nicenic.com/reseller/whmcs.php

Què Pot i No Pot Fer NiceNIC
NiceNIC pot ajudar a revisar l'accés API des del costat del registrado, la documentació API, l'estat del compte revendedo, la configuració de l'API, l'ús del punt final i els detalls de la resposta de l'API relacionats amb l'API NiceNIC Revendedor v2.
No obstant això, alguns problemes poden dependre de la vostra pròpia implementació, versió de WHMCS, configuració del mòdul, enton PHP/cURL, tallafocs, proxy, IP de sotida del servido, generació JSON, paràmetres de la sol·licitud, estat del domini, regles del TLD, polítiques de registre o qualitat de dades del client.
Per això, la vostra integració hauria de desar sempre la resposta de l'API i propocionar prou context de la sol·licitud per a la resolució de problemes. Un missatge com "l'API no funciona" habitualment no és suficient per identificar si el problema és d'autenticació, fomat de la sol·licitud, regles de registre, configuració WHMCS o enton del servido.

Preguntes Freqüents
Per què falla la meva sol·licitud de domini encara que el JSON sigui vàlid?
L'acció pot fallar si falten paràmetres obligatòries, el fomat del domini és invàlid, el saldo del compte és insuficient, l'estat del domini no permet l'acció sol·licitada o el TLD té requisits especials de registre.

Puc enviar una URL completa en comptes d'un nom de domini?
Per a accions de domini, nomalment heu d'enviar el nom de domini en si, com example.com, no una URL completa com https://example.com/page.

Per què WHMCS falla encara que la meva prova d'API personalitzada funcioni?
WHMCS pot utilitzar diferents configuracions de mòdul, mode de prova, enton del servido, configuracions PHP/cURL, IP de sotida o credencials d'API emmagatzemades. Comproveu la configuració i registres del mòdul registrado WHMCS per separat.

Què hauria de provar primer després de coregir el fomat de la sol·licitud?
Comenceu amb una acció de baix risc com comprovació de disponibilitat de domini, comprovació de saldo de compte, consulta de preus o recuperació de llista de dominis abans d'habilitar registres, renovacions, transferències o actualitzacions DNS en viu.

Construeix una Integració API Més Neta amb NiceNIC
Un cop el vostre punt final, capçaleres, Content-Tipus, cos JSON, paràmetres requerits, fomat de domini, regles TLD i configuració de WHMCS siguin corectes, podeu continuar construint un flux de treball de revenedo més fiable amb l'API NiceNIC Revendedor v2.



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