Prezentare generală API
Documentație API Domenii NiceNIC v2 și Ghid de pornire rapidă
API-ul NiceNIC Domain v2 este disponibil atât pentru conturile de piață (Market Accounts), cât și pentru conturile de reseller (Reseller Accounts). Utilizați această prezentare generală pentru a configura accesul, pentru a confirma prima solicitare, pentru a înțelege modelul de răspuns al API-ului și pentru a ajunge direct la secțiunea corectă din navigarea din stânga.
Accesul API și prețurile pentru reseller sunt separate.
Cont de piață: acces API cu prețuri pentru conturile de piață.
Cont de reseller: acces API cu prețurile atribuite nivelului actual de reseller.
Compară nivelurile și prețurile de reseller →
Cont de piață: acces API cu prețuri pentru conturile de piață.
Cont de reseller: acces API cu prețurile atribuite nivelului actual de reseller.
Compară nivelurile și prețurile de reseller →
Endpoint de bază
https://api.nicenic.net/v2/
Antete necesare
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Răspuns standard de succes
{ "code": 0, "msg": "success", "data": {} }
Mediu de testare API
Testează integrarea înainte de a trece în producție
Folosește sandbox-ul API NiceNIC pentru a testa integrarea Domain API înainte de a trece în producție. Validează autentificarea, cererile API, gestionarea răspunsurilor și fluxul aplicației tale într-un mediu de testare dedicat.
Ideal pentru revânzători, furnizori de găzduire, dezvoltatori și platforme care pregătesc o integrare API.
Început rapid
Realizează primul apel API în 4 pași
Începe cu o cerere doar în citire înainte de a activa înregistrările, reînnoirile sau transferurile live. Acest lucru îți permite să validezi autentificarea, formatarea cererii și gestionarea răspunsurilor fără a plasa o comandă plătită.
1
Activează accesul API
Deschide Setările API, creează sau recuperează Secretul API și configurează adresele IP de server autorizate, acolo unde este cazul.
2
Confirmare autentificare
Utilizați HTTPS cu antetul Authorization în formatul username:api_secret.
3
Rulează un test sigur
Începe cu verificarea disponibilității domeniului, prețuri, soldul contului sau listarea domeniilor.
4
Gestionarea răspunsului
Citiți și stocați code și msg returnate înainte de a activa acțiunile de producție plătite.
Prima solicitare recomandată: Verificarea disponibilității domeniului
Endpoint-ul de disponibilitate acceptă mai multe domenii într-o singură cerere prin separarea numelor de domenii cu virgule.
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"
Harta API
Alegeți fluxul de lucru de care aveți nevoie
Prezentarea de mai jos oglindește navigarea din stânga. Folosiți-o pentru a identifica fluxul de lucru corect, apoi deschideți pagina dedicată punctului final pentru parametri, exemple de cereri și exemple de răspunsuri.
| Secțiune | Utilizare pentru | Funcții documentate |
|---|---|---|
| Început rapid | Conectați-vă în siguranță și înțelegeți gestionarea răspunsurilor. | Prezentare generală API, API Sandbox, Autentificare, Coduri de răspuns. |
| Gestionarea domeniilor | Automatizați ciclul de viață de bază al domeniilor. | Disponibilitate, Listare domenii, Detalii domeniu, Înregistrare, Reînnoire, Transfer intrare, Servere de nume, Contacte, Prețuri. |
| Abuz & Conformitate | Monitorizați domeniile care necesită atenție în ceea ce privește conformitatea. | Listați domeniile cu rapoarte de abuz și obțineți stare de abuz lizibilă automat, ciclul de viață al blocării, informații despre plângeri și acțiuni recomandate. |
| Înregistrări DNS | Gestionați programatic înregistrările DNS găzduite. | Listați, creați, actualizați și ștergeți înregistrările DNS. |
| Servere de nume secundare | Gestionați înregistrările host / glue pentru serverele de nume sub propriul dvs. domeniu. | Creați, listați, actualizați și ștergeți serverele de nume secundare. |
| Cont și facturare | Conectați automatizarea la verificările la nivel de cont. | Soldul contului și informațiile de cont legate de tranzacții. |
| API WHMCS | Integrați NiceNIC într-un flux de lucru de facturare WHMCS existent. | Disponibilitate, Înregistrare, Reînnoire, Transfer, Detalii domeniu, Servere de nume, Contacte și funcții suplimentare ale modulului de registrar. |
| FAQ API | Rezolvați întrebările frecvente privind accesul, securitatea, testarea și fluxul de lucru. | Eligibilitate, credențiale, gestionarea cererilor, operațiuni acceptate și îndrumări de integrare. |
Flux de lucru recomandat
Secvența de integrare recomandată pentru început
O integrare de producție fiabilă ar trebui să valideze condițiile de acces și de achiziție înainte de a începe să trimită comenzi live ale clienților.
1. Autentificare
API Secret + IP autorizat
API Secret + IP autorizat
→
2. Disponibilitate
Test de conectivitate doar pentru citire
Test de conectivitate doar pentru citire
→
3. Prețuri
Interogare cost actual la nivel de cont
Interogare cost actual la nivel de cont
→
4. Sold
Confirmarea fondurilor pentru acțiuni cu plată
Confirmarea fondurilor pentru acțiuni cu plată
→
5. Gestionarea răspunsului
Procesare cod + msg
Procesare cod + msg
→
6. Operațiuni live
Înregistrare / Reînnoire / Transfer
Înregistrare / Reînnoire / Transfer
Nu presupuneți că o solicitare API este completă doar pentru că a fost acceptată. Unele operațiuni pot returna o stare de așteptare și pot necesita în continuare procesarea registrului înainte de confirmarea stării finale a domeniului.
Comportament în producție
Înțelegeți răspunsurile de succes, în așteptare și de eroare
code: 0 — Răspuns de succes Exemplele de endpoint actuale folosesc codul 0 pentru răspunsurile finalizate cu succes.
code: 201 — Comandă în așteptare Documentația pentru înregistrare și transfer poate returna codul 201 atunci când o comandă a fost trimisă, dar procesarea finală este încă în așteptare.
code: 400 — Eroare de solicitare Exemplele de endpoint folosesc codul 400 pentru erorile de parametri de solicitare.
Comportamentul înregistrărilor în așteptare
Pentru înregistrarea de domenii, documentația actuală prevede că un răspuns 201 înseamnă că comanda a fost trimisă cu succes și taxa a fost dedusă, dar activarea finală este încă supusă confirmării registrului. Dacă domeniul nu poate fi activat, taxa de înregistrare este returnată în soldul contului NiceNIC în termen de 24 de ore.
Comportamentul transferului în așteptare
Endpoint-ul de transfer documentează, de asemenea, codul 201 ca o comandă în așteptare. Prin urmare, aplicația dvs. ar trebui să trateze un transfer în așteptare ca fiind acceptat pentru procesare, nu ca dovadă că transferul s-a finalizat deja.
Prețuri
Interogați prețurile înainte de operațiunile plătite
Punctul de acces pentru prețuri al NiceNIC poate obține prețurile de înregistrare, reînnoire și transfer pentru un domeniu. Valorile type documentate sunt register, renew, transfer și all. Perioada documentată este de 1 până la 10 ani, cu posibile excepții specifice fiecărui TLD.
Răspunsurile privind prețurile de înregistrare pot returna și un indicator is_premium. Utilizați punctul de acces pentru prețuri înainte de a trimite o cerere plătită atunci când aplicația dvs. trebuie să cunoască costul curent la nivel de cont.
Accesul gratuit la API nu modifică nivelul dvs. de prețuri. Conturile de tip Market utilizează prețurile pentru conturi Market; conturile de reseller utilizează prețurile atribuite nivelului lor actual de reseller.
Operațiuni de domeniu și DNS
Aflați diferența dintre serverele de nume, înregistrările DNS și serverele de nume subordonate
| Operațiune | Când se folosește | Capabilitate documentată |
|---|---|---|
| Actualizează Servere de Nume | Doriți să delegați un domeniu către diferite servere de nume autoritare. | Endpoint-ul pentru servere de nume de domeniu acceptă servere de nume primare, secundare și suplimentare, iar pagina curentă documentează o limită de până la șase. |
| Înregistrări DNS | Utilizați serviciul de găzduire DNS NiceNIC și trebuie să gestionați înregistrările de zonă. | Sunt documentate API-uri separate pentru listarea, crearea, actualizarea și ștergerea înregistrărilor DNS. |
| Servere de nume secundare | Aveți nevoie de înregistrări host / glue, cum ar fi ns1.example.com. |
Creați, listați, actualizați și ștergeți nameservere secundare. Endpoint-ul de creare necesită ca hostname-ul nameserverului să corespundă domeniului și acceptă o adresă IP. |
Portofoliu și conformitate
Automatizați monitorizarea portofoliului, nu doar comenzile de domenii
Domain API v2 include, de asemenea, operațiuni de citire utile după înregistrare. Endpoint-ul List Domains acceptă paginarea, sortarea, filtrarea după stare și filtrarea după blocare, în timp ce Get Domain Details returnează datele de înregistrare, datele de expirare, serverele de nume și informațiile de contact ale deținătorului.
Monitorizarea abuzurilor și conformității
API-ul de abuzuri și conformitate NiceNIC poate lista domeniile cu rapoarte de abuz și poate returna un rezumat detaliat, lizibil automat, pentru un anumit domeniu. Punctul final detaliat de abuz documentează șase fraze de stare la nivel de domeniu: Normal, În revizuire, ClientHold în așteptare, ClientHold, Închis și ServerHold.
Răspunsul poate include impactul actual, următoarea acțiune recomandată, starea și cronologia blocării, numărul de reclamații, datele reclamațiilor, categoriile, clasificarea abuzului DNS, starea dovezilor și URL-urile raportate acolo unde este cazul. Acest lucru permite platformelor și revânzătorilor să afișeze starea conformității în propriile sisteme operaționale, în loc să se bazeze doar pe revizuirea manuală.
API direct sau WHMCS
Alegeți modelul de integrare care se potrivește sistemului dvs.
| Opțiune | Potrivit pentru | Ce oferă documentația actuală |
|---|---|---|
| Domain API v2 | Site-uri web personalizate, platforme SaaS, sisteme interne, fluxuri de facturare sau de furnizare personalizate. | Integrare directă HTTPS + JSON pentru operațiuni de domenii, DNS, nameservere secundare, cont și conformitate. |
| Modul WHMCS | Companii de găzduire și revânzători care utilizează deja WHMCS. | Disponibilitate, înregistrare, reînnoire, transfer, detalii domeniu, nameservere, contacte, blocare/deblocare, recuperare EPP, înregistrarea erorilor și modul de testare opțional. |
Documentația actuală WHMCS enumeră ca cerințe WHMCS 7.0 sau o versiune ulterioară, PHP 7.0 sau o versiune ulterioară cu cURL, credențiale API NiceNIC valide și suport SSL/TLS.
Depanare
Când o cerere API eșuează
Începeți cu răspunsul returnat și starea configurației, în loc să reîncercați repetat aceeași acțiune plătită.
Eroare de autentificare sau de acces
- Confirmați numele de utilizator NiceNIC și Secretul API.
- Confirmați că header-ul Authorization este prezent și formatat corect.
- Confirmați că Secretul API nu a fost resetat sau rotit.
- Dacă restricțiile IP sunt activate, confirmați că cererea provine de la adresa IP de ieșire autorizată a serverului.
Eroare de parametru de solicitare
- Comparați solicitarea cu parametrii documentați ai punctului final specific.
- Confirmați valorile obligatorii, formatele și numele acțiunilor.
- Verificați perioadele de înregistrare specifice TLD sau cerințele de contact, acolo unde este cazul.
Operațiunea plătită nu se finalizează imediat
- Citiți
codeșimsgreturnate. - Nu tratați un răspuns
201în așteptare ca fiind finalizare definitivă. - Confirmați soldul contului și prețurile curente înainte de a reîncerca o acțiune plătită.
Aveți nevoie de asistență NiceNIC?
- Înregistrați timestamp-ul solicitării și acțiunea API.
- Includeți numele de domeniu sau obiectul implicat, acolo unde este cazul.
- Includeți codul și mesajul returnate.
- Partajați doar parametrii nesensibili; nu publicați niciodată întregul API Secret într-un bilet de asistență.
Următorul pas
Începeți cu o cerere de test sigură
Activați accesul API, confirmați autentificarea, rulați o cerere de disponibilitate sau de preț și verificați gestionarea răspunsului înainte de a activa operațiunile plătite destinate clienților.
Ultima verificare: 26 august 2026
