Preguntes freqüents
1) Què és la Reseller API v2 de NiceNIC?
L’API v2 és la interfície renovada de NiceNIC en estil REST que permet als revenders automatitzar totes les accions del cicle de vida dels dominis — registre, transferència, renovació, modificació WHOIS i gestió DNS — a través de peticions HTTPS segures i respostes JSON.
2) En què es diferencia l’API v2 de l’API antiga?
La versió 2 ofereix una resposta més ràpida, una autenticació simplificada, una millor gestió d'errors i una sortida completament basada en JSON en comptes de cadenes de consultes antigues. Està dissenyada per facilitar la integració amb aplicacions i frameworks moderns.
3) Com puc obtenir les credencials de l'API?
Un cop siguis un revendedor verificat, accedeix al teu panell i visita la secció "Configuració de l'API". Allà podràs generar una clau API i un Token secret per comen?ar a enviar sol·licituds autenticades immediatament.
4) Què puc fer amb l'API?
Pots cercar la disponibilitat de dominis, registrar-ne de nous, renovar els existents, transferir dominis amb codis EPP, actualitzar la informació WHOIS, gestionar registres DNS, consultar el saldo del compte i consultar l’estat dels dominis — tot això sense necessitat d’entrar manualment.
5) Quins llenguatges de programació són compatibles?
Qualsevol llenguatge que suporti peticions HTTPS funciona amb l’API. Normalment, els desenvolupadors utilitzen PHP (amb cURL), Python (requests), Node.js (axios o fetch) o Java. S’hi publiquen exemples de scripts en PHP directament en aquesta pàgina.
6) Com es garanteix la seguretat a l’API v2?
Totes les sol·licituds utilitzen HTTPS i credencials API vàlides. Es pot configurar una llista blanca d’IPs per restringir l’accés als vostres servidors. Els tokens estan xifrats i s’aplica limitació de taxa per protegir tant els usuaris com la xarxa del registrador.
7) Quins són els comandaments API més comuns disponibles?
Els punts finals típics inclouen:
registre de domini per a noves inscripcions
transferència de domini per a transferències entrants
renovació de domini per a renovacions
informació del domini per a consulta WHOIS
dns-modify per actualitzacions de servidor de noms o registres
account-balance per comprovar els crèdits del revenedor
8) Què puc fer si una sol·licitud API falla?
L'API retorna un codi d'error clar i un missatge en format JSON. Els problemes més comuns inclouen credencials incorrectes, IPs no autoritzades o paràmetres erronis. Revisa el missatge de resposta o contacta amb el nostre equip d'atenció amb el registre de la sol·licitud per a una resolució ràpida.
9) On puc trobar documentació detallada i exemples de codi?
Totes les referències d’endpoint, els paràmetres, els exemples d’autenticació i els scripts de demostració PHP estan disponibles directament a la pàgina de documentació de NiceNIC Reseller API v2:http://www.unionroom.cn/reseller/apiv2.php. També podeu contactar amb el nostre equip de suport per a revenedors per obtenir ajuda amb la integració.
