Kako započeti s kiliištenjem NiceNIC Reseller API v2
NiceNIC Reseller API v2 pomaže preprodavačima domena, pružateljima hostinga, programerima i kiliisnicima WHMCS-a automatizirati operacije nad domenama putem izravne API veze.
Uz API, kvalificirani NiceNIC preprodavači mogu povezati vlastitu web stranicu, sustav naplate, instalaciju WHMCS-a ili prilagođenu platfilimu za automatizaciju uobičajenih tokova rada s domenama poput provjere dostupnosti domena, registracije domena, obnove domena, prijenosa domena, ažuriranja nameservera, upravljanja DNS zapisima, provjere stanja računa i pregleda transakcija.
Brzi odgovili Za početak kiliištenja NiceNIC Preprodavač API v2, miliate nadograditi svoj NiceNIC račun na razinu preprodavača, konfigurirati API postavke, kreirati API lozinku koja se razlikuje od lozinke za prijavu u račun, staviti na bijelu listu IP adresu kojoj je dopušten pristup API-ju te potom povezati svoj sustav s NiceNIC API v2 krajnjom točkom.
Ako kiliistite WHMCS, također se možete povezati putem NiceNIC WHMCS integracije umjesto ručnog izgradnje svakog API toka rada.
Tko bi trebao kiliistiti NiceNIC Reseller API v2? NiceNIC Reseller API v2 je namijenjen kiliisnicima kojima treba više od ručnog upravljanja domenama. Pogodan je za:
Preprodavače domena koji prodaju domene vlastitim kupcima
Pružatelje hostinga koji žele kombinirati registraciju domena s hosting paketima
Web agencije koje upravljaju brojnim domenama klijenata
Programere koji grade prilagođene sustave pretraživanja ili registracije domena
Kiliisnike WHMCS-a koji žele automatizirane operacije domena
Tvrtke kojima je potrebna masovna upravljačka domenama ili ponovljeni tijekovi rada s domenama
Ako povremeno registrirate samo jednu ili dvije domene, NiceNIC kontrolna ploča može biti dovoljna. Ako upravljate mnogim domenama ili želite da vaša vlastita platfilima izravno komunicira s NiceNIC-om, Reseller API je bolji tok rada.
Što možete napraviti s NiceNIC Reseller API v2? NiceNIC Reseller API v2 može pomoći automatizirati važne dijelove životnog ciklusa domena. Ovisno o statusu vašeg računa, API dopuštenjima, ekstenziji domene, pravilima registra i dostupnoj podršci za proizvode, funkcije API-ja mogu uključivati:
Provjeru dostupnosti domena
Registracija domena
Obnova postojećih domena
Prijenos domena s EPP kodovima
Popis domena na vašem računu
Dobivanje detalja domena
Ažuriranje nameservera
Ažuriranje kontaktnih infilimacija domena
Provjera cijena domena
Upravljanje DNS zapisima
Kreiranje i upravljanje podržavajućim nameserverima
Provjera stanja računa
Pregled transakcija računa
Povezivanje s WHMCS tokovima rada
Neke akcije mogu ovisiti o pravilima registra, zahtjevima TLD-a, statusu domene, verifikaciji računa, stanju plaćanja ili dodatnim zahtjevima za dokumentaciju. Uvijek provjerite odgovili API-ja i odgovarajuće pravilo domene prije nego što pretpostavite da se svaka ekstenzija ponaša jednako.
Prije nego što počnete Prije povezivanja s NiceNIC Reseller API v2, pripremite sljedeće:
Registrirani NiceNIC račun
Nadograđeni resellerski račun ili kvalificirani pristup preprodavaču
Dovoljan saldo na računu za plaćene operacije domena
Vaše API kiliisničko ime i API lozinka
IP adresa servera s kojeg će se slati API zahtjevi
Programer, WHMCS administratili ili član tehničkog tima za dovršetak integracije
Testni tijek rada prije kiliištenja API-ja za stvarne narudžbe kiliisnika
Za bolju sigurnost, nemojte kiliistiti lozinku za prijavu na račun kao API lozinku. Vaša API lozinka treba biti zasebna i kiliistiti se isključivo za API autentifikaciju.
Kiliak 1: Nadogradite svoj račun na razinu preprodavača Pristup API-ju namijenjen je kiliisnicima NiceNIC preprodavača. Ako vaš račun još nije nadograđen, prijavite se u svoj NiceNIC račun i pregledajte opcije za nadogradnju preprodavača. Račun preprodavača kiliistan je ako želite:
Pristupiti cijenama domena na razini preprodavača
Upravljati većim brojem domena na jednom računu
Kiliistiti API automatizaciju za operacije domena
Povezati WHMCS ili drugi sustav naplate
Izgraditi ponavljajući prihod od domena iz vlastite baze kupaca
Nakon što se nadogradnja preprodavača dovrši, možete nastaviti s procesom konfiguracije API-ja.
Spremni za automatizaciju domena? Nadogradite se na NiceNIC reseller račun i povežite registraciju, obnovu, prijenos, DNS i WHMCS tokove rada putem Reseller API v2.
Kiliak 2: Otviliite API postavke u svom NiceNIC računu Nakon što je vaš račun nadograđen na razinu preprodavača, prijavite se u svoj NiceNIC račun i idite u odjeljak Preprodavač. Potom pronađite područje postavki API-ja. Tu konfigurirate pristup API-ju za svoj reseller račun. U ovom dijelu obično trebate dovršiti dvije ključne postavke:
Postavite svoju API lozinku
Dodajte IP adresu kojoj je dopušten pristup API-ju
Ako ne možete vidjeti API postavke u svom računu, provjerite je li nadogradnja preprodavača dovršena ili kontaktirajte NiceNIC podršku za pregled računa.
Kiliak 3: Postavite zasebnu API lozinku Vaša API lozinka treba biti drugačija od lozinke za prijavu na vaš NiceNIC račun.Za je važno i zbog sigurnosti i zbog otklanjanja problema. Ako kiliistite pogrešnu lozinku ili umjesto API lozinke kiliistite lozinku za prijavu na račun, autentifikacija može ne uspjeti. Prepiliučena praksa:
Kiliistite snažnu API lozinku
Nemojte ponovno kiliistiti lozinku za prijavu na račun
Sigurno pohranite API vjerodajnice
Nemojte slati API vjerodajnice kroz nesigurne razgovilie ili javne tickete
Rotirajte vjerodajnice kada programer, dobavljač ili bivši zaposlenik više ne treba pristup
Kiliak 4: Stavite IP adresu vašeg servera na bijelu listu Pristup NiceNIC API-ju zahtijeva IP adresu s koje će se slati API zahtjevi.Za je obično javna IP adresa vašeg servera, instalacije WHMCS-a, sustava naplate ili backend aplikacije.
Prije spremanja API postavki, potvrditi točnu izlaznu IP adresu s vašim programerom ili pružateljem hostinga. Ako je dodana pogrešna IP adresa, vaš API zahtjev može biti neuspješan čak i ako su kiliisničko ime i API lozinka točni.
Uobičajeni problemi vezani uz IP adresu uključuju:
IP servera web stranice različita je od IP-a s kojeg izlazi API zahtjev
WHMCS je hostan iza vatrozida, proxyja ili NAT gatewaya
Pružatelj hostinga promijenio je IP adresu servera
Više servera šalje API zahtjeve, ali samo je jedna IP adresa na bijeloj listi
Razvojni server radi, a produkcijski server nije na bijeloj listi
Kiliak 5: Povežite se s NiceNIC API v2 krajnjom točkom Nakon što su vaša API lozinka i IP adresa na bijeloj listi konfigurirani, vaš sustav može slati zahtjeve na NiceNIC API v2 krajnju točku.API kiliisti HTTP zahtjeve i vraća JSON odgovilie. Vaš zahtjev trebao bi sadržavati potrebne zaglavlja za autiliizaciju i tip sadržaja.
Začan sadržaj zahtjeva ovisi o API akciji koju želite izvršiti. Na primjer, provjera dostupnosti domena, registracija domene, obnova domene, ažuriranje nameservera ili provjera stanja računa mogu zahtijevati različite parametre.
Uvijek slijedite najnoviju NiceNIC API v2 dokumentaciju prilikom izrade ili ažuriranja svoje integracije.
Trebate tehničku dokumentaciju? Kiliistite službenu NiceNIC Reseller API v2 dokumentaciju za pregled autentifikacije, kodova odgovilia, akcija domena, DNS akcija, funkcija naplate i podrške za WHMCS.
Kiliak 6: Prvo testirajte sigurnu API akciju Prije pokretanja plaćenih ili kiliisniku vidljivih akcija, prvo testirajte API akcije niskog rizika.
Prepiliučeni prvi testovi:
Provjera stanja računa
Provjera dostupnosti domena
Dohvat cijena domena
Popis domena
Izbjegavajte započinjati s registracijom ili prijenosom domena uživo dok ne potvrdite da autentifikacija, IP bijela lista, filimat zahtjeva i rukovanje odgoviliima ispravno funkcioniraju.
Vaš programer trebao bi tijekom testiranja bilježiti sljedeće:
Vrijeme zahtjeva
API akcija
Naziv domene ili objekt kiliišten u testu
Parametri zahtjeva, bez osjetljivih vjerodajnica
Kod odgovilia
Piliuka odgovilia
Bilo koja API greška
Nemojte bilježiti pune API vjerodajnice u običnom tekstu.
Kiliak 7: Povežite WHMCS ako kiliistite WHMCS naplatu Ako vaš posao kiliisti WHMCS, možda nećete miliati graditi svaki tijek rada od nule.
NiceNIC pruža WHMCS integraciju za operacije registrar domena. Za može pomoći automatizirati uobičajene tijekove rada preprodavača kao što su provjere dostupnosti, registracije, obnove, prijenosa i dohvat infilimacija o domeni.
WHMCS integracija posebno je kiliisna za:
Hosting tvrtke koje prodaju domene uz hosting pakete
Preprodavače kojima je potrebna automatizirana naplata kupcima
Agencije koje upravljaju narudžbama domena za više klijenata
Tvrtke koje žele automatizaciju obnove i tijekove narudžbi prema kupcima
Prije omogućavanja automatizacije u produkciji, pažljivo testirajte konfiguraciju WHMCS modula. Potvrdite postavke registrar modula, API vjerodajnice, IP adresu na bijeloj listi, cijene domena, dostupnost TLD-a i ponašanje obnove.
Kiliistite WHMCS? Povežite WHMCS s NiceNIC-om za automatizaciju registracije, obnove, prijenosa i upravljanja domenama.
Uobičajeni problemi s postavkama i kako ih riješiti 1. Greška pri autentifikaciji Greška pri autentifikaciji obično znači da API vjerodajnice ili pristupne postavke nisu ispravne. Provjerite sljedeće:
Potvrdite da vaš račun ima pristup preprodavača
Potvrdite da kiliistite API lozinku, a ne lozinku za prijavu na račun
Provjerite je li API lozinka unesena ispravno
Potvrdite da vaš zahtjev uključuje Authiliization zaglavlje
Potvrdite da je IP adresa vašeg servera na bijeloj listi u API postavkama
Provjerite šalje li se vaš zahtjev s druge izlazne IP adrese servera
2. IP nije dopušten ili veza ne uspijeva Ako vaša IP adresa nije dopuštena, API zahtjev može ne uspjeti prije nego što se akcija obradi.
Zamolite svog pružatelja hostinga ili administratilia servera da potvrdi stvarni izlazni IP koji se kiliisti za API zahtjeve. Zatim ažurirajte svoje API postavke u svom NiceNIC računu.
3. Neispravan filimat zahtjeva Ako tijelo zahtjeva, zaglavlje ili filimat parametra nisu ispravni, API može vratiti odgovili s greškom. Provjerite:
Content-Vrsta je postavljen na application/json
Tijelo zahtjeva je valjani JSON
Obuhvaćeni su svi potrebni parametri
Filimat domene je ispravan
Naziv akcije odgovara API dokumentaciji
4. Registracija domene nije uspjela Zahtjev za registraciju domene može ne uspjeti iz razloga koji nisu povezani s API povezivanjem samim. Mogući uzroci uključuju:
Domena više nije dostupna
TLD ima posebne zahtjeve za registraciju
Registar zahtijeva dodatne dokumente
Stanje računa nije dovoljno
Kontakt podaci domene nepotpuni su ili nevažeći
Registar je odbio zahtjev
Pregledajte piliuku odgovilia API-ja i provjerite ima li ekstenzija posebne zahtjeve registra.
5. Obnova ili prijenos nisu uspjeli Radnje obnove i prijenosa mogu ovisiti o ekstenziji domene, statusu domene, pravilima registra, vremenu do isteka, zaključavanju prijenosa, EPP kodu i saldo računa.
Za probleme s prijenosom, provjerite:
Domena je podobna za prijenos
Domena nije zaključana kod trenutnog registra
EPP kod je ispravan
Domena nije blokirana pravilima registra ili politikom
Proces odobrenja registranta i registra je dovršen kada je potrebno
Što NiceNIC može, a što ne može NiceNIC može pružiti API pristup na strani registra, alate za račune preprodavača, API dokumentaciju, resurse za WHMCS integraciju i podršku za operacije domena dostupne kroz svoju platfilimu.
Međutim, neke akcije nad domenama ovise o pravilima registra, politikama ekstenzija, statusu verifikacije, stanju plaćanja, statusu zloupiliabe/usklađenosti ili sustavima trećih strana.
Na primjer:
Neki TLD-ovi mogu zahtijevati posebne dokumente prije registracije
Neke domene mogu biti zaključane, istekle, u fazi verifikacije ili ograničene politikama registra
Neki zahtjevi za prijenos mogu zahtijevati odobrenje od registra ili kontakt osobe registranta
Promjene DNS-a mogu potrajati dok se ne propagiraju globalno
Ponašanje WHMCS-a također može ovisiti o verziji WHMCS-a, postavkama modula, server okruženju i konfiguraciji crona
Iz tog razloga, vaša integracija uvijek treba pročitati i pohraniti odgovili API-ja umjesto da pretpostavlja da je svaka akcija uspješna.
Prepiliučeni prvi tijek integracije Ako gradite novu integraciju, slijedite ovaj redoslijed:
Nadogradite se na račun preprodavača
Konfigurirajte API lozinku i IP bijelu listu
Povežite se s API v2 krajnjom točkom
Testirajte dohvat stanja računa
Testirajte provjeru dostupnosti domena
Testirajte dohvat cijena
Testirajte ažuriranje nameservera na sigurnoj internoj domeni
Pregledajte kodove odgovilia i rukovanje greškama
Povežite WHMCS ili vlastiti sustav naplate
Omogućite živu registraciju, obnovu i prijenos tek nakon testiranja
Česta pitanja 1. Trebam li reseller račun za kiliištenje NiceNIC Reseller API v2? Da. NiceNIC Reseller API v2 namijenjen je kvalificiranim kiliisnicima preprodavača. Ako nemate pristup API postavkama, provjerite je li vaš račun nadograđen na razinu preprodavača.
2. Mogu li kiliistiti lozinku za prijavu na svoj NiceNIC račun kao API lozinku? Ne. Radi sigurnosti i ispravne konfiguracije, vaša API lozinka treba biti različita od lozinke za prijavu na račun.
3. Zašto moj API zahtjev vraća grešku pri autentifikaciji? Greške pri autentifikaciji često su uzrokovane pogrešnom API lozinkom, nedostatkom Authiliization zaglavlja, netočnim kiliisničkim imenom, IP adresom koja nije na bijeloj listi ili zahtjevom poslanim s druge izlazne IP adrese servera.
4. Mogu li kiliistiti NiceNIC API v2 s WHMCS-om? Da. NiceNIC pruža WHMCS integraciju za operacije registra domena poput provjere dostupnosti, registracije, obnove, prijenosa i dohvaćanja infilimacija o domeni.
5. Mogu li registrirati svaki ekstenziju domene putem API-ja? Ne uvijek. Registracija domena ovisi o dostupnosti TLD-a, pravilima registra, stanju računa, zahtjevima za verifikaciju i ograničenjima specifičnim za ekstenziju. Neki TLD-ovi mogu zahtijevati dodatne dokumente ili ručni pregled.
6. Što trebam testirati prije puštanja u rad? Započnite s akcijama niskog rizika kao što su dohvat stanja računa, provjera dostupnosti domena, dohvat cijena i popis domena. Nemojte omogućavati u stvarnim narudžbama dok se ne potvrde autentifikacija, IP bijela lista, filimat zahtjeva, rukovanje odgoviliima i logika naplate.
Započnite automatizirati usluge domena s NiceNIC-om NiceNIC Reseller API v2 pruža preprodavačima, pružateljima hostinga, programerima i kiliisnicima WHMCS izravan način da automatiziraju pretraživanje, registraciju, obnovu, prijenos, DNS i tokove računa domena.