Întrebări frecvente despre API-ul NiceNIC Domain v2

NiceNIC Domain API v2 este o API bazată pe HTTPS și JSON pentru automatizarea gestionării domeniilor prin contul dumneavoastră NiceNIC.

Acceptă fluxuri de lucru esențiale, inclusiv verificarea disponibilității domeniilor, înregistrare, reînnoire, transfer, interogări de portofoliu, actualizări de servere de nume și contacte, prețuri, înregistrări DNS, servere de nume secundare, informații despre cont și operațiuni legate de conformitate.

Utilizați API atunci când doriți să conectați serviciile de domenii NiceNIC direct la un site web, o platformă de găzduire, un sistem de facturare, un instrument intern sau altă aplicație.

Orice cont NiceNIC activ poate utiliza Domain API v2. Accesul la API este disponibil atât pentru conturile de tip Market, cât și pentru conturile de revânzător.

Nu este necesar să deveniți revânzător doar pentru a obține acces la API. Tipul de cont contează totuși pentru prețuri: operațiunile API cu plată folosesc prețurile atribuite contului NiceNIC care trimite cererea.

Deschideți Setări API →

Da. Accesul la API este gratuit în sine. Nu există o taxă separată pentru activarea accesului la API sau pentru trimiterea cererilor API acceptate.

Operațiunile cu plată, cum ar fi înregistrarea, reînnoirea și transferul de domenii, sunt facturate conform prețurilor contului tău și regulilor aplicabile pentru domenii.

Nu. Accesul la API și prețurile pentru reseller sunt separate.

Poți utiliza Domain API v2 cu un cont NiceNIC Market obișnuit. Fă upgrade la un cont de reseller doar atunci când prețurile de reseller sau alte beneficii pentru reseller sunt utile pentru volumul tău de afaceri.

Compară planurile pentru reseller →

Domain API v2 utilizează structura actuală a API NiceNIC cu cereri HTTPS, răspunsuri JSON, autentificare bazată pe antet și documentație organizată în jurul fluxurilor de lucru individuale pentru domenii și conturi.

Dacă menții o integrare construită pe un API NiceNIC mai vechi, analizează parametrii API v2 și gestionarea răspunsurilor înainte de a migra traficul de producție, fără a presupune că cele două versiuni sunt interschimbabile.

Autentifică-te în contul tău NiceNIC și deschide Setările API. Cererile API v2 utilizează numele de utilizator NiceNIC și API Secret pentru autentificare.

Deschideți Setări API →

Da. NiceNIC oferă un API Sandbox pentru ca dezvoltatorii să testeze integrările înainte de a le conecta la API-ul de producție.

Utilizați Sandbox-ul pentru a valida autentificarea, formatarea cererilor, parsarea răspunsurilor, gestionarea erorilor și fluxul aplicației dvs. înainte de a activa operațiunile live cu domenii pentru clienți.

Deschideți API Sandbox →

API-ul Sandbox este destinat dezvoltării și testării integrărilor. API-ul de producție este utilizat pentru operațiuni live cu domenii și cereri plătite efectuate pe contul dvs. NiceNIC.

Recomandăm validarea autentificării, gestionarea cererilor, procesarea răspunsurilor și logica de erori în Sandbox înainte de a activa operațiunile de producție destinate clienților.

Trimiteți cererile API prin HTTPS și includeți numele de utilizator NiceNIC și Secretul API în antetul Authorization.

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

Dacă pentru contul dvs. sunt activate restricțiile de IP, solicitările trebuie să provină și de pe o adresă IP de server autorizată.

Citiți Autentificarea API →

Endpoint-ul de bază pentru API-ul de producție este:

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

Acțiunile API sunt selectate folosind parametrii documentați pentru fiecare endpoint, cum ar fi category și action. Urmați întotdeauna documentația dedicată a endpoint-ului pentru parametrii obligatorii și opționali ai unei operațiuni specifice.

Răspunsurile API v2 utilizează JSON, iar parametrii cererilor utilizează UTF-8.

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

Aplicația dvs. ar trebui să inspecteze code și msg returnate, în loc să presupună că fiecare răspuns HTTP reprezintă o operațiune de domeniu finalizată.

Prin intermediul API-urilor documentate în prezent, puteți automatiza fluxurile de lucru, inclusiv verificarea disponibilității domeniilor, înregistrarea, reînnoirea și transferul, listarea portofoliului și detaliile domeniului, actualizările serverelor de nume și ale contactelor de domeniu, prețurile domeniilor, înregistrările DNS, serverele de nume subsidiare, informațiile despre cont și monitorizarea Abuz & Conformitate.

Fluxurile de lucru suplimentare sunt documentate individual în navigarea API.

Începeți cu operațiuni de citire cu risc scăzut, cum ar fi verificarea disponibilității domeniului, prețurile domeniului, soldul contului și listarea domeniilor.

Apoi confirmați autentificarea, analiza răspunsurilor, gestionarea erorilor și gestionarea comenzilor în așteptare înainte de a activa înregistrările, reînnoirile sau transferurile live.

Da. Punctul final Check Domain Availability acceptă mai multe nume de domenii separate prin virgule.

example.com,example.net,example.org

Nu presupuneți că fiecare operațiune API acceptă același format de introducere pentru mai multe domenii. Înregistrarea, reînnoirea și transferul ar trebui să urmeze documentația individuală a punctului final.

Utilizați endpoint-ul Get Domain Pricing. Tipurile de preț documentate includ register, renew, transfer și all.

Răspunsurile la înregistrare pot include, de asemenea, o valoare is_premium care indică dacă înregistrarea interogată este premium.

Deoarece comenzile API utilizează prețuri la nivel de cont, interogați prețurile curente înainte de a trimite comenzi plătite ale clienților, în loc să vă bazați nelimitat pe prețuri stocate în cache.

Nu. Deși documentația API acceptă perioade de până la 1–10 ani pentru extensiile aplicabile, fiecare TLD poate avea reguli diferite ale registrului.

Perioadele de înregistrare, perioadele de reînnoire, eligibilitatea pentru transfer, cerințele de contact și cerințele de verificare pot diferi în funcție de extensie. Aplicația dvs. ar trebui să urmeze regulile actuale pentru TLD-ul relevant.

Acestea sunt operațiuni separate și nu trebuie tratate ca interschimbabile.

Utilizați întotdeauna codul și mesajul returnate pentru a determina starea unei cereri API.

Vizualizați codurile de răspuns API →

Un răspuns 201 înseamnă că operațiunea a fost acceptată pentru procesare, dar nu a atins neapărat starea finală.

Pentru înregistrarea unui domeniu, un răspuns 201 indică faptul că comanda a fost trimisă și așteaptă procesarea finală de către registru.

Nu spuneți unui client final că domeniul este activ până când sistemul dumneavoastră nu a confirmat rezultatul final. Urmați documentația punctului final de înregistrare pentru cele mai recente reguli privind comenzile în așteptare și rambursările.

Un transfer în așteptare înseamnă că cererea de transfer a fost acceptată pentru procesare, nu că domeniul a fost deja transferat integral către NiceNIC.

Finalizarea transferului poate depinde de procesarea efectuată de registru și registrar, precum și de starea actuală a transferului domeniului. Păstrați transferul în stare de așteptare până la confirmarea finalizării.

Da. API-ul List Domains acceptă recuperarea portofoliului cu opțiuni de paginare, sortare și filtrare.

Utilizați Get Domain Details atunci când aveți nevoie de informații detaliate pentru un anumit domeniu, cum ar fi informațiile de înregistrare, informațiile de expirare, serverele de nume și datele de contact ale domeniului.

NiceNIC Domain API v2 include operațiuni Abuse & Compliance destinate platformelor și revânzătorilor care gestionează portofoliile de domenii ale clienților.

Puteți identifica domeniile asociate cu rapoartele de abuz și puteți obține informații de conformitate citibile automat pentru domeniile individuale. În funcție de caz, răspunsul poate include starea domeniului, impactul actual, acțiunea recomandată, informațiile de suspendare, informațiile despre plângeri și URL-urile raportate.

Astfel, puteți afișa starea conformității direct în propriul portal pentru clienți sau în sistemul operațional.

Da. NiceNIC oferă o integrare WHMCS pentru registrari, destinată companiilor care utilizează deja WHMCS pentru facturare și furnizare.

Utilizați API-ul direct pentru Domenii v2 atunci când construiți propria aplicație sau flux de lucru. Utilizați integrarea WHMCS atunci când doriți ca operațiunile cu domenii să fie integrate într-un mediu WHMCS existent.

Vizualizați integrarea WHMCS →

Orice limbaj de programare sau runtime de tip server-side capabil să trimită cereri HTTPS și să analizeze JSON se poate integra cu Domain API v2.

Opțiunile comune includ PHP, Python, Node.js și Java. Păstrați acreditările API pe partea de server și nu expuneți niciodată API Secret în JavaScript din browser sau în cod client descărcabil.

Se pot aplica limite de rată pentru a proteja stabilitatea API și securitatea platformei.

Dacă integrarea dvs. de producție este de așteptat să genereze un volum ridicat susținut de cereri, contactați NiceNIC înainte de lansare, astfel încât modelul de utilizare preconizat să poată fi analizat.

Includeți marca temporală a cererii, categoria și acțiunea API, numele de domeniu acolo unde este cazul, parametrii nesensibili ai cererii, codul de răspuns și mesajul returnate, precum și dacă cererea a provenit din Sandbox sau Production.

Trimiteți un bilet →

Folosiți navigarea API din documentație. Fiecare operațiune are propria pagină pentru parametrii acceptați, exemple de cereri, exemple de răspunsuri și comportamentul specific operațiunii.

FAQ-ul explică comportamentul general al API; documentația individuală a endpoint-urilor trebuie considerată sursa de referință pentru formatul exact al cererii.

Deschideți documentația API →