Pregled API-ja
NiceNIC Domain API v2 dokumentacija i brzi početak
NiceNIC Domain API v2 dostupan je i za Market račune i za Reseller račune. Koristite ovaj pregled za konfiguraciju pristupa, potvrdu prvog zahtjeva, razumijevanje modela API odgovora i izravan odlazak na odgovarajući odjeljak u lijevoj navigaciji.
Pristup API-ju i cijene za preprodavače su odvojeni.
Market račun: API pristup s cijenama za Market račun.
Preprodavački račun: API pristup s cijenama dodijeljenim trenutnoj razini preprodavača.
Usporedite razine preprodavača i cijene →
Market račun: API pristup s cijenama za Market račun.
Preprodavački račun: API pristup s cijenama dodijeljenim trenutnoj razini preprodavača.
Usporedite razine preprodavača i cijene →
Osnovna krajnja točka
https://api.nicenic.net/v2/
Obavezni zaglavlja
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Standardni uspješni odgovor
{ "code": 0, "msg": "success", "data": {} }
API pješčanik
Testirajte svoju integraciju prije pokretanja uživo
Koristite NiceNIC API Sandbox za testiranje integracije Domain API-ja prije prelaska na produkciju. Provjerite autentifikaciju, API zahtjeve, obradu odgovora i tijek rada vaše aplikacije u namjenskom okruženju za testiranje.
Idealno za preprodavače, pružatelje hostinga, programere i platforme koje pripremaju API integraciju.
Brzi početak
Napravite svoj prvi API poziv u 4 koraka
Započnite sa zahtjevom samo za čitanje prije omogućavanja registracija, produženja ili prijenosa uživo. To vam omogućuje provjeru autentifikacije, formatiranja zahtjeva i obrade odgovora bez naručivanja plaćene narudžbe.
1
Omogući API pristup
Otvori API postavke, stvori ili dohvati svoju API tajnu i konfiguriraj ovlaštene IP adrese poslužitelja ako je primjenjivo.
2
Potvrdi autentifikaciju
Koristi HTTPS sa zaglavljem Authorization u formatu username:api_secret.
3
Pokreni siguran test
Započni s provjerom dostupnosti domene, cijenama, stanjem računa ili popisom domena.
4
Obradi odgovor
Pročitaj i pohrani vraćene code i msg prije omogućavanja plaćenih produkcijskih radnji.
Preporučeni prvi zahtjev: Dostupnost domene
Krajnja točka za dostupnost podržava više domena u jednom zahtjevu odvajanjem naziva domena zarezima.
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"
Karta API-ja
Odaberite tijek rada koji vam je potreban
Pregled u nastavku odražava lijevu navigaciju. Koristite ga za identifikaciju ispravnog tijeka rada, a zatim otvorite namjensku stranicu krajnje točke za parametre, primjere zahtjeva i primjere odgovora.
| Odjeljak | Čemu služi | Dokumentirane funkcije |
|---|---|---|
| Prvi koraci | Povežite se sigurno i razumite rukovanje odgovorima. | Pregled API-ja, API pješčanik, Autentifikacija, Kodovi odgovora. |
| Upravljanje domenama | Automatizirajte osnovni životni ciklus domene. | Dostupnost, Popis domena, Pojedinosti o domeni, Registracija, Obnova, Prijenos, Nameserveri, Kontakti, Cijene. |
| Zlouporaba i sukladnost | Pratite domene koje zahtijevaju pozornost zbog usklađenosti. | Navedite domene s prijavama zlouporabe i dohvatite strojno čitljiv status zlouporabe, životni ciklus zadržavanja, informacije o pritužbama i preporučenu radnju. |
| DNS zapisi | Upravljajte zapisima DNS-a putem programskog sučelja. | Navedite, kreirajte, ažurirajte i brišite DNS zapise. |
| Podređeni nameserveri | Upravljajte zapisima host / glue za nameservere unutar vlastite domene. | Kreirajte, navedite, ažurirajte i brišite podređene nameservere. |
| Račun i naplata | Povežite automatizaciju s provjerama na razini računa. | Stanje računa i informacije o računu povezane s transakcijama. |
| WHMCS API | Integrirajte NiceNIC u postojeći WHMCS naplatni tijek rada. | Dostupnost, Registracija, Obnova, Prijenos, Pojedinosti o domeni, Nameserveri, Kontakti i dodatne funkcije registrarskog modula. |
| API česta pitanja | Riješite uobičajena pitanja o pristupu, sigurnosti, testiranju i radnim postupcima. | Uvjeti prihvatljivosti, vjerodajnice, obrada zahtjeva, podržane operacije i smjernice za integraciju. |
Preporučeni radni postupak
Preporučeni redoslijed prve integracije
Pouzdana produkcijska integracija treba provjeriti uvjete pristupa i kupnje prije nego što počne slati stvarne narudžbe kupaca.
1. Autentifikacija
API tajni ključ + ovlaštena IP adresa
API tajni ključ + ovlaštena IP adresa
→
2. Dostupnost
Test povezivanja samo za čitanje
Test povezivanja samo za čitanje
→
3. Cijene
Provjera trenutnih troškova na razini računa
Provjera trenutnih troškova na razini računa
→
4. Stanje računa
Potvrda sredstava za plaćene radnje
Potvrda sredstava za plaćene radnje
→
5. Obrada odgovora
Obrada koda + poruke
Obrada koda + poruke
→
6. Stvarne operacije
Registracija / Obnova / Prijenos
Registracija / Obnova / Prijenos
Nemojte pretpostaviti da je API zahtjev dovršen samo zato što je prihvaćen. Neke operacije mogu vratiti status "na čekanju" i još uvijek zahtijevaju obradu u registru prije nego što se potvrdi konačno stanje domene.
Ponašanje u produkciji
Razumijevanje odgovora uspjeha, čekanja i pogreške
code: 0 — Uspješan odgovor Primjeri trenutnih krajnjih točaka koriste code 0 za uspješno dovršene odgovore.
code: 201 — Narudžba na čekanju Dokumentacija za registraciju i prijenos može vratiti code 201 kada je narudžba podnesena, ali konačna obrada još uvijek čeka.
code: 400 — Pogreška zahtjeva Primjeri krajnjih točaka koriste code 400 za pogreške parametara zahtjeva.
Ponašanje pri čekanju registracije
Za registraciju domene, trenutna dokumentacija navodi da 201 odgovor znači da je narudžba uspješno podnesena i da je naknada terećena, ali konačna aktivacija još uvijek podliježe potvrdi registra. Ako se domena ne može aktivirati, naknada za registraciju vraća se na saldo računa NiceNIC u roku od 24 sata.
Ponašanje pri čekanju prijenosa
Krajnja točka za prijenos također dokumentira 201 kao narudžbu na čekanju. Vaša aplikacija stoga treba tretirati prijenos na čekanju kao prihvaćen za obradu, a ne kao dokaz da je prijenos već dovršen.
Cijene
Upit za cijene prije plaćenih operacija
NiceNIC-ova krajnja točka za cijene može dohvatiti cijene registracije, obnove i prijenosa za domenu. Dokumentirane type vrijednosti su register, renew, transfer i all. Dokumentirano razdoblje je od 1 do 10 godina, uz moguće iznimke specifične za TLD.
Odgovori za cijene registracije također mogu vratiti oznaku is_premium. Koristite krajnju točku za cijene prije slanja plaćenog zahtjeva kada vaša aplikacija treba znati trenutnu cijenu na razini računa.
Besplatan API pristup ne mijenja vašu razinu cijena. Tržišni računi koriste cijene tržišnih računa; računi preprodavača koriste cijene dodijeljene njihovoj trenutnoj razini preprodavača.
Operacije s domenama i DNS-om
Znajte razliku između poslužitelja imena, DNS zapisa i podređenih poslužitelja imena
| Operacija | Kada je koristiti | Dokumentirana mogućnost |
|---|---|---|
| Ažuriranje imenskih poslužitelja | Želite delegirati domenu različitim autoritativnim poslužiteljima imena. | Krajnja točka za poslužitelje imena domene podržava primarni, sekundarni i dodatne poslužitelje imena, a trenutna stranica dokumentira ograničenje do šest. |
| DNS zapisi | Koristite NiceNIC DNS hosting i trebate upravljati zapisima zona. | Zasebni API-ji dokumentirani su za popisivanje, kreiranje, ažuriranje i brisanje DNS zapisa. |
| Podređeni nameserveri | Treba vam host / glue zapis poput ns1.example.com. |
Kreirajte, popišite, ažurirajte i obrišite podređene nameservere. Create krajnja točka zahtijeva da naziv poslužitelja odgovara domeni i prihvaća IP adresu. |
Portfelj i usklađenost
Automatizirajte praćenje portfelja, ne samo narudžbe domena
Domain API v2 također uključuje operacije čitanja koje su korisne nakon registracije. List Domains krajnja točka podržava paginaciju, sortiranje, filtriranje po statusu i filtriranje po zadržavanju, dok Get Domain Details vraća datume registracije, datume isteka, nameservere i podatke za kontakt registranta.
Praćenje zlouporabe i usklađenosti
NiceNIC-ov Abuse & Compliance API može popisati domene s prijavama zlouporabe i vratiti detaljan strojno čitljiv sažetak za određenu domenu. Detaljna krajnja točka za zlouporabu dokumentira šest statusnih fraza na razini domene: Normalno, U pregledu, Na čekanju ClientHold, ClientHold, Zatvoreno i ServerHold.
Odgovor može uključivati trenutni utjecaj, preporučenu sljedeću radnju, stanje zadržavanja i vremenski okvir, broj pritužbi, datume pritužbi, kategorije, klasifikaciju DNS zlouporabe, status dokaza i prijavljene URL-ove gdje je primjenjivo. To omogućava platformama i preprodavačima da prikažu status usklađenosti unutar vlastitih operativnih sustava umjesto da se oslanjaju samo na ručni pregled.
Izravni API ili WHMCS
Odaberite model integracije koji odgovara vašem sustavu
| Opcija | Najprikladnije za | Što pruža trenutna dokumentacija |
|---|---|---|
| Domain API v2 | Prilagođene web stranice, SaaS platforme, interne sustave, prilagođene postupke naplate ili provizioniranja. | Izravna HTTPS + JSON integracija za operacije s domenama, DNS-om, nadređenim imenskim poslužiteljima, računima i usklađenošću. |
| WHMCS modul | Tvrtke za hosting i preprodavače koji već koriste WHMCS. | Provjera dostupnosti, registracija, obnova, prijenos, pojedinosti o domeni, imenski poslužitelji, kontakti, zaključavanje/otključavanje, dohvat EPP-a, evidentiranje pogrešaka i opcionalni testni način rada. |
Trenutna WHMCS dokumentacija navodi WHMCS 7.0 ili noviju verziju, PHP 7.0 ili noviju verziju s cURL-om, valjane NiceNIC API vjerodajnice te SSL/TLS podršku kao preduvjete.
Rješavanje problema
Kada API zahtjev ne uspije
Započnite s vraćenim odgovorom i konfiguracijskim stanjem umjesto ponovnog pokušaja iste plaćene radnje.
Pogreška autentifikacije ili pristupa
- Potvrdite NiceNIC korisničko ime i API tajnu.
- Potvrdite da je Authorization zaglavlje prisutno i ispravno formatirano.
- Potvrdite da API tajna nije resetirana ili rotirana.
- Ako su ograničenja IP-a omogućena, potvrdite da zahtjev dolazi s autorizirane poslužiteljske IP adrese.
Pogreška parametra zahtjeva
- Usporedite zahtjev s dokumentiranim parametrima odgovarajućeg krajnje točke.
- Potvrdite potrebne vrijednosti, formate i nazive radnji.
- Provjerite razdoblja registracije specifična za TLD ili zahtjeve za kontakt, gdje je primjenjivo.
Plaćena operacija ne dovršava se odmah
- Pročitajte vraćeni
codeimsg. - Ne tretirajte odgovor s kodom
201u statusu čekanja kao konačni dovršetak. - Provjerite stanje računa i trenutne cijene prije ponovnog pokušaja plaćene radnje.
Trebate podršku NiceNIC-a?
- Zabilježite vremensku oznaku zahtjeva i API radnju.
- Uključite naziv domene ili objekt na koji se odnosi, ako je primjenjivo.
- Uključite vraćeni kod i poruku.
- Dijelite samo neosjetljive parametre; nikada ne objavljujte cijeli API tajni ključ u zahtjevu.
Sljedeći korak
Započnite sigurnim testnim zahtjevom
Omogućite API pristup, potvrdite autentifikaciju, pokrenite zahtjev za provjeru dostupnosti ili cijena te provjerite obradu odgovora prije nego uključite plaćene operacije namijenjene kupcima.
Posljednja provjera: 26. kolovoza 2026.
