Domande frequenti sull'API Domain v2 di NiceNIC

NiceNIC Domain API v2 è un'API basata su HTTPS e JSON per automatizzare la gestione dei domini tramite il tuo account NiceNIC.

Supporta i flussi di lavoro principali, tra cui verifica della disponibilità dei domini, registrazione, rinnovo, trasferimento, query sul portafoglio, aggiornamenti di nameserver e contatti, prezzi, record DNS, nameserver figli, informazioni sull'account e operazioni relative alla conformità.

Utilizza l'API quando desideri collegare i servizi di dominio NiceNIC direttamente a un sito web, una piattaforma di hosting, un sistema di fatturazione, uno strumento interno o un'altra applicazione.

Qualsiasi account NiceNIC attivo può utilizzare Domain API v2. L'accesso API è disponibile sia per gli account di mercato (Market Accounts) sia per gli account rivenditore (Reseller Accounts).

Non è necessario diventare rivenditore solo per ottenere l'accesso API. Il tipo di account influisce comunque sui prezzi: le operazioni API a pagamento utilizzano i prezzi assegnati all'account NiceNIC che invia la richiesta.

Apri Impostazioni API →

Sì. L'accesso API è gratuito. Non è prevista alcuna commissione separata per abilitare l'accesso API o per inviare richieste API supportate.

Le operazioni a pagamento come registrazione, rinnovo e trasferimento di domini vengono addebitate in base alla tariffazione del tuo account e alle regole applicabili per i domini.

No. L'accesso API e le tariffe da rivenditore sono separati.

Puoi utilizzare Domain API v2 con un normale account NiceNIC Market. Passa a un account rivenditore solo quando le tariffe da rivenditore o altri vantaggi per rivenditori risultano utili per il tuo volume di attività.

Confronta i piani rivenditore →

Domain API v2 utilizza la struttura API NiceNIC attuale con richieste HTTPS, risposte JSON, autenticazione basata su intestazioni e documentazione organizzata per singoli flussi di lavoro relativi a domini e account.

Se gestisci un'integrazione basata su una versione precedente dell'API NiceNIC, verifica i parametri di API v2 e la gestione delle risposte prima di migrare il traffico di produzione, senza dare per scontato che le due versioni siano intercambiabili.

Accedi al tuo account NiceNIC e apri API Settings. Le richieste API v2 utilizzano il tuo nome utente NiceNIC e l'API Secret per l'autenticazione.

Apri Impostazioni API →

Sì. NiceNIC offre un ambiente di test API per consentire agli sviluppatori di testare le integrazioni prima di collegarle all'API di produzione.

Utilizza l'ambiente di test per validare l'autenticazione, la formattazione delle richieste, l'analisi delle risposte, la gestione degli errori e il flusso di lavoro della tua applicazione prima di abilitare le operazioni reali sui domini dei clienti.

Apri l'ambiente di test API →

L'ambiente di test API è destinato allo sviluppo e al test di integrazione. L'API di produzione viene utilizzata per operazioni reali sui domini e richieste a pagamento sul tuo account NiceNIC.

Consigliamo di validare l'autenticazione, la gestione delle richieste, l'elaborazione delle risposte e la logica degli errori nell'ambiente di test prima di abilitare le operazioni di produzione rivolte ai clienti.

Invia richieste API via HTTPS e includi il tuo nome utente NiceNIC e il segreto API nell'intestazione Authorization.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

Se per il tuo account sono attive restrizioni IP, le richieste devono inoltre provenire da un IP server autorizzato.

Leggi Autenticazione API →

L'endpoint di base dell'API di produzione è:

https://api.nicenic.net/v2/

Le azioni API vengono selezionate tramite i parametri documentati per ciascun endpoint, come category e action. Segui sempre la documentazione dedicata dell'endpoint per conoscere i parametri obbligatori e facoltativi di una specifica operazione.

Le risposte dell'API v2 utilizzano JSON e i parametri delle richieste utilizzano UTF-8.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

La tua applicazione deve verificare i valori code e msg restituiti, invece di presupporre che ogni risposta HTTP rappresenti un'operazione sul dominio completata.

Tramite le API attualmente documentate è possibile automatizzare flussi di lavoro come la verifica della disponibilità dei domini, la registrazione, il rinnovo e il trasferimento, l'elenco del portfolio e i dettagli dei domini, gli aggiornamenti dei nameserver e dei contatti del dominio, i prezzi dei domini, i record DNS, i nameserver figlio, le informazioni sull'account e il monitoraggio di Abusi e Conformità.

Ulteriori flussi di lavoro sono documentati singolarmente nella navigazione delle API.

Inizia con operazioni di lettura a basso rischio come la verifica della disponibilità dei domini, i prezzi dei domini, il saldo dell'account e l'elenco dei domini.

Successivamente, verifica l'autenticazione, l'analisi delle risposte, la gestione degli errori e la gestione degli ordini in sospeso prima di abilitare registrazioni, rinnovi o trasferimenti in tempo reale.

Sì. L'endpoint Check Domain Availability supporta più nomi di dominio separati da virgole.

example.com,example.net,example.org

Non dare per scontato che ogni operazione API supporti lo stesso formato di input multi-dominio. Registrazione, rinnovo e trasferimento devono seguire la documentazione del rispettivo endpoint.

Utilizzare l'endpoint Get Domain Pricing. I tipi di prezzo documentati includono register, renew, transfer e all.

Le risposte di registrazione possono anche includere un valore is_premium che indica se la registrazione interrogata è premium.

Poiché gli ordini API utilizzano i prezzi a livello di account, interroga i prezzi correnti prima di inviare ordini a pagamento dei clienti, anziché fare affidamento indefinitamente su prezzi memorizzati nella cache.

No. Sebbene la documentazione API supporti periodi fino a 1–10 anni per le estensioni applicabili, i singoli TLD possono avere regole di registro differenti.

I periodi di registrazione, i periodi di rinnovo, l'idoneità al trasferimento, i requisiti di contatto e i requisiti di verifica possono variare a seconda dell'estensione. La tua applicazione deve seguire le regole correnti per il TLD pertinente.

Queste sono operazioni separate e non devono essere trattate come intercambiabili.

Per determinare lo stato di una richiesta API, utilizzare sempre il codice e il messaggio restituiti.

Visualizza i codici di risposta API →

Una risposta 201 indica che l'operazione è stata accettata per l'elaborazione, ma non è necessariamente giunta al suo stato finale.

Per la registrazione di un dominio, una risposta 201 indica che l'ordine è stato inviato ed è in attesa dell'elaborazione finale da parte del registro.

Non comunicare al cliente finale che il dominio è attivo finché il tuo sistema non ha confermato il risultato finale. Segui la documentazione dell'endpoint di registrazione per le regole più aggiornate relative agli ordini in sospeso e alla gestione dei rimborsi.

Un trasferimento in sospeso significa che la richiesta di trasferimento è stata accettata per l'elaborazione, non che il dominio ha già completato il trasferimento a NiceNIC.

Il completamento del trasferimento può dipendere dall'elaborazione del registro e del registrar, nonché dallo stato di trasferimento corrente del dominio. Mantieni il trasferimento in stato di attesa finché non viene confermato il completamento.

Sì. L'API List Domains supporta il recupero del portafoglio con opzioni di paginazione, ordinamento e filtraggio.

Utilizza Get Domain Details quando hai bisogno di informazioni dettagliate per un singolo dominio, come dati di registrazione, dati di scadenza, nameserver e informazioni di contatto del dominio.

NiceNIC Domain API v2 include operazioni Abuse & Compliance progettate per piattaforme e rivenditori che gestiscono portafogli di domini dei clienti.

Puoi identificare i domini associati a segnalazioni di abuso e recuperare informazioni di conformità leggibili da machine per singoli domini. A seconda del caso, la risposta può includere lo stato del dominio, l'impatto attuale, l'azione consigliata, le informazioni sull'hold, le informazioni sui reclami e gli URL segnalati.

Ciò rende possibile visualizzare lo stato di conformità direttamente all'interno del tuo portale clienti o del tuo sistema operativo.

Sì. NiceNIC fornisce un'integrazione registrar WHMCS per le aziende che utilizzano già WHMCS per la fatturazione e il provisioning.

Se stai creando la tua applicazione o il tuo flusso di lavoro, utilizza l'API diretta per domini v2. Se desideri integrare le operazioni relative ai domini in un ambiente WHMCS esistente, utilizza l'integrazione WHMCS.

Visualizza l'integrazione WHMCS →

Qualsiasi linguaggio di programmazione server-side o runtime in grado di inviare richieste HTTPS e analizzare JSON può integrarsi con API per domini v2.

Le scelte comuni includono PHP, Python, Node.js e Java. Mantieni le credenziali API lato server e non esporre mai il tuo segreto API in JavaScript lato browser o in codice client scaricabile.

Potrebbe essere applicato un limite di frequenza per proteggere la stabilità delle API e la sicurezza della piattaforma.

Se la tua integrazione in produzione dovesse generare un volume elevato e continuo di richieste, contatta NiceNIC prima del lancio in modo che il tuo modello di utilizzo previsto possa essere valutato.

Includi il timestamp della richiesta, la categoria e l'azione dell'API, il nome di dominio quando applicabile, i parametri della richiesta non sensibili, il codice e il messaggio di risposta restituiti e se la richiesta proviene da sandbox o produzione.

Invia un ticket →

Usa la navigazione API nella documentazione. Ogni operazione ha una propria pagina per i parametri supportati, gli esempi di richiesta, gli esempi di risposta e il comportamento specifico dell'operazione.

Le FAQ spiegano il comportamento generale dell'API; la documentazione dei singoli endpoint deve essere considerata la fonte autorevole per il formato esatto delle richieste.

Apri la documentazione API →