Panoramica API
Documentazione NiceNIC Domain API v2 e Guida rapida
NiceNIC Domain API v2 è disponibile sia per gli account di mercato che per gli account rivenditori. Utilizza questa panoramica per configurare l'accesso, confermare la tua prima richiesta, comprendere il modello di risposta API e passare direttamente alla sezione corretta nella navigazione a sinistra.
L'accesso API e i prezzi rivenditore sono separati.
Account di mercato: accesso API con i prezzi dell'account di mercato.
Account rivenditore: accesso API con i prezzi assegnati al livello rivenditore corrente.
Confronta i livelli e i prezzi rivenditore →
Account di mercato: accesso API con i prezzi dell'account di mercato.
Account rivenditore: accesso API con i prezzi assegnati al livello rivenditore corrente.
Confronta i livelli e i prezzi rivenditore →
Endpoint di base
https://api.nicenic.net/v2/
Intestazioni obbligatorie
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Risposta standard di successo
{ "code": 0, "msg": "success", "data": {} }
Sandbox API
Testa la tua integrazione prima di andare in produzione
Utilizza l'API Sandbox di NiceNIC per testare la tua integrazione Domain API prima di passare alla produzione. Valida l'autenticazione, le richieste API, la gestione delle risposte e il flusso della tua applicazione in un ambiente di test dedicato.
Ideale per rivenditori, provider di hosting, sviluppatori e piattaforme che stanno preparando un'integrazione API.
Guida rapida
Effettua la tua prima chiamata API in 4 passaggi
Inizia con una richiesta di sola lettura prima di abilitare registrazioni, rinnovi o trasferimenti live. Questo ti consente di convalidare l'autenticazione, la formattazione delle richieste e la gestione delle risposte senza effettuare un ordine a pagamento.
1
Abilita l'accesso API
Apri le impostazioni API, crea o recupera il tuo segreto API e configura gli IP dei server autorizzati dove applicabile.
2
Conferma autenticazione
Utilizza HTTPS con l'intestazione Authorization nel formato username:api_secret.
3
Esegui un test sicuro
Inizia con la disponibilità del dominio, i prezzi, il saldo del conto o l'elenco dei domini.
4
Gestire la risposta
Leggere e memorizzare i valori code e msg restituiti prima di abilitare le azioni di produzione a pagamento.
Prima richiesta consigliata: disponibilità del dominio
L'endpoint di disponibilità supporta più domini in una singola richiesta separando i nomi di dominio con virgole.
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"
Mappa API
Scegli il flusso di lavoro che ti serve
La panoramica seguente rispecchia il menu di navigazione a sinistra. Utilizzala per identificare il flusso di lavoro corretto, quindi apri la pagina dell'endpoint dedicata per consultare parametri, esempi di richiesta ed esempi di risposta.
| Sezione | A cosa serve | Funzioni documentate |
|---|---|---|
| Per Iniziare | Connettiti in modo sicuro e comprendi la gestione delle risposte. | Panoramica API, API Sandbox, Autenticazione, Codici di risposta. |
| Gestione Domini | Automatizza il ciclo di vita principale dei domini. | Disponibilità, Elenco domini, Dettagli dominio, Registrazione, Rinnovo, Trasferimento in ingresso, Nameserver, Contatti, Prezzi. |
| Abuso e conformità | Monitora i domini che richiedono attenzione per la conformità. | Elenca i domini con segnalazioni di abuso e recupera lo stato di abuso leggibile da macchina, il ciclo di vita del hold, le informazioni sui reclami e l'azione consigliata. |
| Record DNS | Gestisci i record DNS ospitati a livello programmatico. | Elenca, crea, aggiorna ed elimina record DNS. |
| Nameserver figli | Gestisci i record host / glue per i nameserver sotto il tuo dominio. | Crea, elenca, aggiorna ed elimina nameserver secondari. |
| Account e fatturazione | Collega l'automazione ai controlli a livello di account. | Saldo dell'account e informazioni relative alle transazioni. |
| WHMCS API | Integra NiceNIC in un flusso di lavoro di fatturazione WHMCS esistente. | Disponibilità, registrazione, rinnovo, trasferimento, dettagli del dominio, nameserver, contatti e funzioni aggiuntive del modulo registrar. |
| FAQ sulle API | Risolvi domande comuni su accesso, sicurezza, test e flussi di lavoro. | Idoneità, credenziali, gestione delle richieste, operazioni supportate e guida all'integrazione. |
Flusso di lavoro consigliato
Sequenza di integrazione consigliata per iniziare
Un'integrazione di produzione affidabile dovrebbe verificare le condizioni di accesso e di acquisto prima di iniziare a inviare ordini clienti reali.
1. Autenticazione
Segreto API + IP autorizzato
Segreto API + IP autorizzato
→
2. Disponibilità
Test di connettività in sola lettura
Test di connettività in sola lettura
→
3. Prezzi
Consulta il costo attuale a livello di account
Consulta il costo attuale a livello di account
→
4. Saldo
Verifica i fondi per le azioni a pagamento
Verifica i fondi per le azioni a pagamento
→
5. Gestione delle risposte
Elabora codice + msg
Elabora codice + msg
→
6. Operazioni live
Registra / Rinnova / Trasferisci
Registra / Rinnova / Trasferisci
Non dare per scontato che una richiesta API sia completa solo perché è stata accettata. Alcune operazioni possono restituire uno stato in sospeso e richiedere comunque l'elaborazione del registro prima che lo stato finale del dominio sia confermato.
Comportamento in produzione
Comprendere le risposte di successo, in sospeso e di errore
code: 0 — Risposta di successo Gli esempi di endpoint attuali utilizzano code 0 per le risposte completate con successo.
code: 201 — Ordine in sospeso La documentazione per registrazione e trasferimento può restituire code 201 quando un ordine è stato inviato ma l'elaborazione finale è ancora in sospeso.
code: 400 — Errore di richiesta Gli esempi di endpoint utilizzano code 400 per errori nei parametri della richiesta.
Comportamento in caso di registrazione in sospeso
Per quanto riguarda la registrazione dei domini, la documentazione attuale indica che una risposta 201 significa che l'ordine è stato inviato correttamente e che la tariffa è stata addebitata, ma l'attivazione definitiva resta soggetta alla conferma del registrar. Se il dominio non può essere attivato, la tariffa di registrazione viene rimborsata sul saldo dell'account NiceNIC entro 24 ore.
Comportamento in caso di trasferimento in sospeso
L'endpoint di trasferimento documenta anche 201 come ordine in sospeso. La tua applicazione deve quindi trattare un trasferimento in sospeso come accettato per l'elaborazione, non come prova che il trasferimento sia già stato completato.
Prezzi
Verifica i prezzi prima delle operazioni a pagamento
L'endpoint prezzi di NiceNIC può recuperare i prezzi di registrazione, rinnovo e trasferimento di un dominio. I valori type documentati sono register, renew, transfer e all. Il periodo documentato va da 1 a 10 anni, con possibili eccezioni specifiche per TLD.
Le risposte sui prezzi di registrazione possono anche restituire un flag is_premium. Utilizza l'endpoint prezzi prima di inviare una richiesta a pagamento quando la tua applicazione deve conoscere il costo corrente a livello di account.
L'accesso API gratuito non modifica il tuo livello tariffario. Gli account Market utilizzano i prezzi degli account Market; gli account rivenditore utilizzano i prezzi assegnati al loro livello rivenditore corrente.
Operazioni su dominio e DNS
Comprendi la differenza tra nameserver, record DNS e nameserver figli
| Funzionamento | Quando utilizzarlo | Funzionalità documentata |
|---|---|---|
| Aggiorna nameserver | Desideri delegare un dominio a nameserver autoritativi diversi. | L'endpoint del nameserver del dominio supporta nameserver primari, secondari e aggiuntivi, con la pagina corrente che documenta un limite massimo di sei. |
| Record DNS | Stai utilizzando l'hosting DNS di NiceNIC e devi gestire i record di zona. | Sono documentate API separate per elencare, creare, aggiornare ed eliminare i record DNS. |
| Nameserver figli | Hai bisogno di record host / glue come ns1.example.com. |
Crea, elenca, aggiorna ed elimina nameserver figli. L'endpoint di creazione richiede che l'hostname del nameserver corrisponda al dominio e accetta un indirizzo IP. |
Portafoglio e conformità
Automatizza il monitoraggio del portafoglio, non solo gli ordini di domini
L'API Domain v2 include anche operazioni di lettura utili dopo la registrazione. L'endpoint List Domains supporta paginazione, ordinamento, filtro per stato e filtro per hold, mentre Get Domain Details restituisce date di registrazione, date di scadenza, nameserver e informazioni di contatto del titolare.
Monitoraggio abusi e conformità
L'API Abuse & Compliance di NiceNIC può elencare i domini con segnalazioni di abuso e restituire un riepilogo dettagliato e leggibile da macchina per un dominio specifico. L'endpoint di abuso dettagliato documenta sei frasi di stato a livello di dominio: Normal, Under Review, Pending ClientHold, ClientHold, Closed e ServerHold.
La risposta può includere impatto attuale, azione successiva consigliata, stato di blocco e cronologia, numero di reclami, date dei reclami, categorie, classificazione dell'abuso DNS, stato delle prove e URL segnalati, ove applicabile. Ciò consente alle piattaforme e ai rivenditori di visualizzare lo stato di conformità all'interno dei propri sistemi operativi, invece di affidarsi solo alla revisione manuale.
API diretta o WHMCS
Scegli il modello di integrazione più adatto al tuo sistema
| Opzione | Ideale per | Cosa fornisce la documentazione attuale |
|---|---|---|
| Domain API v2 | Siti web personalizzati, piattaforme SaaS, sistemi interni, flussi di fatturazione o provisioning personalizzati. | Integrazione diretta HTTPS + JSON per operazioni su domini, DNS, nameserver secondari, account e conformità. |
| Modulo WHMCS | Società di hosting e rivenditori che utilizzano già WHMCS. | Disponibilità, registrazione, rinnovo, trasferimento, dettagli del dominio, nameserver, contatti, blocco/sblocco, recupero EPP, registrazione degli errori e modalità Test opzionale. |
La documentazione WHMCS attuale elenca come requisiti WHMCS 7.0 o superiore, PHP 7.0 o superiore con cURL, credenziali API NiceNIC valide e supporto SSL/TLS.
Risoluzione dei problemi
Quando una richiesta API fallisce
Inizia dalla risposta restituita e dallo stato di configurazione, invece di ripetere più volte la stessa azione a pagamento.
Errore di autenticazione o accesso
- Verificare il nome utente NiceNIC e l'API Secret.
- Assicurarsi che l'intestazione Authorization sia presente e formattata correttamente.
- Confermare che l'API Secret non sia stato reimpostato o ruotato.
- Se le restrizioni IP sono abilitate, verificare che la richiesta provenga dall'indirizzo IP del server di uscita autorizzato.
Errore nei parametri della richiesta
- Confronta la richiesta con i parametri documentati dell'endpoint specifico.
- Verifica i valori obbligatori, i formati e i nomi delle azioni.
- Controlla i periodi di registrazione o i requisiti di contatto specifici del TLD, se applicabili.
Le operazioni a pagamento non vengono completate immediatamente
- Leggere il
codee ilmsgrestituiti. - Non considerare una risposta in sospeso
201come completamento definitivo. - Verificare il saldo del conto e i prezzi correnti prima di ripetere un'azione a pagamento.
Hai bisogno del supporto NiceNIC?
- Registra il timestamp della richiesta e l'azione API.
- Includi il nome di dominio o l'oggetto coinvolto, se applicabile.
- Includi il codice e il messaggio restituiti.
- Condividi solo parametri non sensibili; non pubblicare mai l'intero segreto API in un ticket.
Passo successivo
Inizia con una Richiesta di Test Sicura
Abilita l'accesso API, conferma l'autenticazione, esegui una richiesta di disponibilità o di prezzo e verifica la gestione delle risposte prima di attivare le operazioni a pagamento rivolte ai clienti.
Ultima verifica: 26 agosto 2026
