Česta pitanja o NiceNIC Domain API v2
Pronađite praktične odgovore o pristupu API-ju, testiranju u pješčaniku, autentifikaciji, cijenama, operacijama s domenama, obradi odgovora i produkcijskoj integraciji.
Prvi koraci
Započnite s pristupom, cijenama i vjerodajnicama.
01 Što je NiceNIC Domain API v2?
NiceNIC Domain API v2 je API temeljen na HTTPS-u i JSON-u za automatizaciju upravljanja domenama putem vašeg NiceNIC računa.
Podržava osnovne radne procese uključujući provjeru dostupnosti domena, registraciju, obnovu, prijenos, upite portfelja, ažuriranje nameservera i kontakata, cijene, DNS zapise, podređene nameservere, informacije o računu i operacije povezane s usklađenošću.
Koristite API kada želite povezati NiceNIC usluge domena izravno s web stranicom, platformom za hosting, sustavom naplate, internim alatom ili drugom aplikacijom.
02 Tko može koristiti NiceNIC Domain API v2?
Svaki aktivni NiceNIC račun može koristiti Domain API v2. Pristup API-ju dostupan je i za Market račune i za Reseller račune.
Ne morate postati reseller samo da biste dobili pristup API-ju. Vrsta računa i dalje utječe na cijene: plaćene API operacije koriste cijene dodijeljene NiceNIC računu koji šalje zahtjev.
03 Je li NiceNIC Domain API v2 besplatan?
Da. Sam pristup API-ju je besplatan. Ne postoji zasebna naknada za omogućavanje pristupa API-ju ili slanje podržanih API zahtjeva.
Plaćene operacije poput registracije domene, obnove i prijenosa naplaćuju se prema cijenama vašeg računa i važećim pravilima za domene.
04 Trebam li račun preprodavača za korištenje API-ja?
Ne. Pristup API-ju i cijene za preprodavače su odvojeni.
Domain API v2 možete koristiti s običnim NiceNIC Market računom. Nadogradite na račun preprodavača samo kada vam cijene za preprodavače ili druge pogodnosti preprodavača budu korisne za vaš poslovni obujam.
05 Po čemu se API v2 razlikuje od starijeg NiceNIC API-ja?
Domain API v2 koristi trenutnu strukturu NiceNIC API-ja s HTTPS zahtjevima, JSON odgovorima, autentifikacijom temeljenom na zaglavljima i dokumentacijom organiziranom oko pojedinačnih tijekova rada za domene i račun.
Ako održavate integraciju izgrađenu na starijem NiceNIC API-ju, pregledajte parametre API v2 i obradu odgovora prije migracije produkcijskog prometa, umjesto da pretpostavite da su dvije verzije međusobno zamjenjive.
06 Kako dobivam svoje API vjerodajnice?
Prijavite se na svoj NiceNIC račun i otvorite API postavke. Zahtjevi API v2 koriste vaše NiceNIC korisničko ime i API tajnu za autentifikaciju.
Testno okruženje i autentifikacija
Povežite se sigurno i testirajte prije produkcije.
07 Nudi li NiceNIC Domain API v2 API Sandbox?
Da. NiceNIC pruža API Sandbox za programere kako bi testirali integracije prije povezivanja na produkcijski API.
Koristite Sandbox za provjeru autentifikacije, formatiranja zahtjeva, parsiranja odgovora, obrade pogrešaka i tijeka vaše aplikacije prije omogućavanja stvarnih korisničkih domenskih operacija.
08 Koja je razlika između Sandbox i produkcijskog API-ja?
API Sandbox namijenjen je razvoju i testiranju integracija. Produkcijski API koristi se za stvarne domenske operacije i plaćene zahtjeve na vašem NiceNIC računu.
Preporučujemo da u Sandboxu provjerite autentifikaciju, obradu zahtjeva, obradu odgovora i logiku pogrešaka prije omogućavanja produkcijskih operacija usmjerenih korisnicima.
09 Kako funkcionira autentifikacija API-ja?
Šaljite API zahtjeve putem HTTPS-a i uključite svoje NiceNIC korisničko ime i API tajnu u Authorization zaglavlje.
Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/jsonAko su za vaš račun omogućena IP ograničenja, zahtjevi također moraju dolaziti s autorizirane poslužiteljske IP adrese.
10 Koji krajnji koristi Domain API v2?
Osnovni krajnji korist za produkcijski API je:
https://api.nicenic.net/v2/Radnje API-ja odabiru se pomoću parametara dokumentiranih za svaki krajnji korist, kao što su category i action. Uvijek slijedite namjensku dokumentaciju krajnjeg korista za potrebne i neobavezne parametre određene operacije.
11 Koji format odgovora i kodiranje znakova koristi API v2?
Odgovori API-ja v2 koriste JSON, a parametri zahtjeva koriste UTF-8.
{
"code": 0,
"msg": "success",
"data": {}
}Vaša aplikacija treba provjeriti vraćene code i msg umjesto da pretpostavlja da svaki HTTP odgovor predstavlja dovršenu operaciju s domenom.
Operacije s domenama i cijene
Razumite podržane radne tijekove i ponašanje pri kupnji.
12 Što mogu učiniti s NiceNIC Domain API v2?
Putem trenutno dokumentiranih API-ja možete automatizirati radne tijekove uključujući provjeru dostupnosti domena, registraciju, obnovu i prijenos, popis portfelja i pojedinosti o domenama, ažuriranje nameservera i kontakata domene, cijene domena, DNS zapise, podređene nameservere, informacije o računu te praćenje zlostavljanja i usklađenosti.
Dodatni tokovi rada pojedinačno su dokumentirani u API navigaciji.
13 Što trebam testirati prije omogućavanja stvarnih registracija ili prijenosa?
Započnite s operacijama čitanja niskog rizika poput provjere dostupnosti domene, cijena domena, stanja računa i popisa domena.
Zatim potvrdite autentifikaciju, parsiranje odgovora, obradu pogrešaka i obradu pending narudžbi prije omogućavanja stvarnih registracija, obnova ili prijenosa.
14 Mogu li provjeriti više domena u jednom API zahtjevu?
Da. Krajnja točka Check Domain Availability podržava više domena odvojenih zarezima.
example.com,example.net,example.orgNemojte pretpostavljati da svaka API operacija podržava isti format unosa za više domena. Registracija, obnova i prijenos trebaju slijediti vlastitu dokumentaciju krajnje točke.
15 Kako mogu upitati cijene registracije, obnove i prijenosa?
Koristite krajnju točku Get Domain Pricing. Dokumentirani tipovi cijena uključuju register, renew, transfer i all.
Odgovori o registraciji mogu također uključivati vrijednost is_premium koja označava je li upitana registracija premium.
Budući da API narudžbe koriste cijene na razini računa, provjerite trenutne cijene prije podnošenja plaćenih narudžbi kupaca umjesto da se neograničeno oslanjate na keširane cijene.
16 Može li se svaka TLD registrirati ili obnoviti na razdoblje od 1–10 godina?
Ne. Iako API dokumentacija podržava razdoblja do 1–10 godina za primjenjive ekstenzije, pojedine TLD mogu imati različita pravila registra.
Razdoblja registracije, razdoblja obnove, uvjeti za prijenos, zahtjevi za kontakt i zahtjevi za verifikaciju mogu se razlikovati ovisno o ekstenziji. Vaša aplikacija treba slijediti trenutna pravila za odgovarajuću TLD.
17 Koja je razlika između Nameservera, DNS zapisa i Child Nameservera?
ns1.example.com.To su odvojene operacije i ne treba ih tretirati kao međusobno zamjenjive.
Odgovori i pogreške
Ispravno upravljajte uspješnim stanjima, stanjima na čekanju i pogreškama.
18 Što znače kodovi API odgovora?
| Kod | Značenje |
|---|---|
0 | Uspjeh |
201 | Na čekanju |
400 | Greška parametra |
401 | Neovlašteno |
404 | Nema pronađenih relevantnih zapisa |
500 | Interna pogreška poslužitelja |
Prilikom određivanja stanja API zahtjeva uvijek koristite vraćeni kod i poruku.
19 Što znači kod 201?
Odgovor 201 znači da je operacija prihvaćena za obradu, ali nije nužno dosegla svoje konačno stanje.
20 Što se događa kada registracija domene vrati kod 201?
Za registraciju domene, odgovor 201 označava da je narudžba poslana i čeka konačnu obradu u matičnom registru.
Nemojte krajnjem korisniku reći da je domena aktivna dok vaš sustav ne potvrdi konačan rezultat. Slijedite dokumentaciju krajnje točke za registraciju radi najnovijih pravila o narudžbama u tijeku i povratima sredstava.
21 Što znači odgovor Pending transfer (prijenos u tijeku)?
Prijenos u tijeku znači da je zahtjev za prijenos prihvaćen za obradu, ali to ne znači da je domena već dovršila prijenos na NiceNIC.
Završetak prijenosa može ovisiti o obradi registra i registrara te o trenutnom statusu prijenosa domene. Prijenos zadržite u statusu na čekanju dok se ne potvrdi dovršetak.
Portfelj, usklađenost i integracija
Upravljajte portfeljima i povežite postojeće sustave.
22 Mogu li dohvatiti i filtrirati svoj portfelj domena putem API-ja?
Da. API List Domains podržava dohvat portfelja s opcijama numeriranja stranica, sortiranja i filtriranja.
Koristite Get Domain Details kada su vam potrebne detaljne informacije o pojedinoj domeni, kao što su podaci o registraciji, podaci o isteku, poslužitelji imena i kontakt podaci domene.
23 Što može Abuse & Compliance API?
NiceNIC Domain API v2 uključuje operacije za zlouporabu i usklađenost (Abuse & Compliance) namijenjene platformama i preprodavačima koji upravljaju portfeljima domena svojih kupaca.
Možete identificirati domene povezane s prijavama zlouporabe i dohvatiti strojno čitljive informacije o usklađenosti za pojedinačne domene. Ovisno o slučaju, odgovor može uključivati status domene, trenutni utjecaj, preporučenu radnju, podatke o zadržavanju, informacije o pritužbama i prijavljene URL-ove.
To omogućuje prikazivanje statusa usklađenosti izravno unutar vašeg vlastitog korisničkog portala ili operativnog sustava.
24 Mogu li koristiti NiceNIC Domain API v2 s WHMCS-om?
Da. NiceNIC pruža WHMCS registrarsku integraciju za tvrtke koje već koriste WHMCS za naplatu i pružanje usluga.
Koristite izravni Domain API v2 kada gradite vlastitu aplikaciju ili radni tijek. Koristite WHMCS integraciju kada želite integrirati operacije s domenama u postojeće WHMCS okruženje.
Razvoj i podrška
Gradite sigurno i znajte što poslati kada vam je potrebna pomoć.
25 Koje programske jezike mogu koristiti?
Bilo koji programski jezik ili izvršno okruženje na strani poslužitelja koje može slati HTTPS zahtjeve i parsirati JSON može se integrirati s Domain API v2.
Uobičajeni izbori uključuju PHP, Python, Node.js i Java. Čuvajte API vjerodajnice na strani poslužitelja i nikada ne izlažite svoj API Secret u JavaScript kodu na strani preglednika ili u preuzimljivom klijentskom kodu.
26 Postoje li ograničenja broja API zahtjeva?
Ograničenja broja zahtjeva mogu se primijeniti radi zaštite stabilnosti API-ja i sigurnosti platforme.
Ako se očekuje da vaša produkcijska integracija generira trajno visok volumen zahtjeva, kontaktirajte NiceNIC prije pokretanja kako bi se vaš očekivani obrazac korištenja mogao pregledati.
27 Što trebam uključiti kada kontaktiram podršku u vezi problema s API-jem?
Uključite vremensku oznaku zahtjeva, kategoriju API-ja i radnju, naziv domene ako je primjenjivo, neosjetljive parametre zahtjeva, vraćeni kod odgovora i poruku te naznaku je li zahtjev poslan iz Sandbox ili Production okruženja.
28 Gdje mogu pronaći potpune parametre zahtjeva i primjere koda?
Koristite API navigaciju u dokumentaciji. Svaka operacija ima vlastitu stranicu s podržanim parametrima, primjerima zahtjeva, primjerima odgovora i ponašanjem specifičnim za operaciju.
FAQ objašnjava opće ponašanje API-ja; dokumentacija za pojedinačni krajnji endpoint treba se smatrati najpouzdanijim izvorom za točan format zahtjeva.
Spremni za početak?
Testirajte svoju integraciju u API Sandbox okruženju, a zatim povežite svoj NiceNIC račun kada budete spremni za produkciju.
Trebate reseller cijene za veći broj domena?
Usporedite planove za preprodavače →
