NiceNIC Reseller API v2 padeda domenų perpardavėjams, prieglobos paslaugų teikėjams, kūrėjams ir WHMCS naudotojams automatizuoti domenų operacijas per tiesioginį API ryšį.
Su API, tinkami NiceNIC perpardavėjai gali prijungti savo svetainę, apskaitos sistemą, WHMCS diegimą arba pasirinktą platfarmą, kad automatizuotų įprastus domenų darbo eigas, tokius kaip domenų prieinamumo patikrinimas, domenų registracija, domenų atnaujinimas, domenų perleidimas, nameserverių atnaujinimai, DNS įrašų valdymas, sąskaitos likučio tikrinimas ir sirarių peržiūra.
Greitas atsakymas Nerėdami pradėti naudotis NiceNIC Platintojas API v2, turite atnaujinti savo NiceNIC paskyrą į perpardavėjo lygį, sukonfigūruoti API nustatymus, sukurti API slaptažodį, kuris skiriasi nuo jūsų paskyros prisijungimo slaptažodžio, įtraukti leidžiamą IP adresą į baltąjį sąrašą ir tada prijungti savo sistemą prie NiceNIC API v2 galutinio taško.
Jei naudojate WHMCS, taip pat galite prisijungti per NiceNIC WHMCS integraciją, o ne kurti kiekvieną API darbo procesą rankiniu būdu.
Kam reikalingas NiceNIC Reseller API v2? NiceNIC Reseller API v2 sukurtas vartotojams, kuriems reikia daugiau nei rankinis domenų valdymas. Jis tinkamas:
Domenų perpardavėjams, parduodantiems domenus savo klientams
Prieglobos paslaugų teikėjams, narintiems derinti domenų registraciją su prieglobos planais
Interneto agentūroms, valdžiusioms daug klientų domenų
Kūrėjams, statantiems pasirinktines domenų paieškos ar registracijos sistemas
Verslams, kuriems reikalingas masinis domenų valdymas arba pasikartojančios domenų darbo eigos
Jei registruojate tik vieną ar du domenus retkarčiais, gali pakakti NiceNIC valdymo pulto. Jei valdote daug domenų arba narite, kad jūsų platfarma tiesiogiai komunikuotų su NiceNIC, Reseller API yra geresnis sprendimas.
Ką galite daryti su NiceNIC Reseller API v2? NiceNIC Reseller API v2 gali padėti automatizuoti svarbias domenų gyvenimo ciklo dalis. Priklausomai nuo jūsų paskyros būsenos, API leidimų, domeno plėtinio, registro taisyklių ir prieinamos produktų palaikymo, API funkcijos gali apimti:
Domenų prieinamumo tikrinimą
Domenų vardų registraciją
Esamų domenų atnaujinimą
Domenų perleidimą su EPP kodais
Domenų sąrašą jūsų paskyroje
Domeno detalių gavimą
Vardasserverių atnaujinimą
Domeno kontaktinės infarmacijos atnaujinimą
Domeno kainų tikrinimą
DNS įrašų valdymą
Vaikinių nameserverių kūrimą ir valdymą
Sąskaitos balanso tikrinimą
Sąskaitos sirarių peržiūrą
Prisijungimą prie WHMCS darbo eigų
Kai kurios operacijos gali priklausyti nuo registro taisyklių, TLD reikalavimų, domeno būsenos, paskyros patvirtinimo, mokėjimų likučio arba papildomų dokumentų reikalavimų. Visada tikrinkite API atsakymą ir susijusią domeno taisyklę prieš manydami, kad kiekvienas plėtinys elgiasi vienodai.
Prieš pradėdami Prieš jungiantis prie NiceNIC Reseller API v2, pasiruoškite šiuos dalykus:
Registruotą NiceNIC paskyrą
Pasnaujintą perpardavėjo paskyrą arba tinkamą perpardavėjo prieigą
Serverio IP adresą, iš kurio bus siunčiami API užklausos
Kūrėją, WHMCS administratarių arba techninį komiros narį, kuris baigs integraciją
Testinę darbo eigą prieš naudojant API gyvoms klientų užsakymams
Geresniam saugumui nenaudokite savo paskyros prisijungimo slaptažodžio kaip API slaptažodžio. Jūsų API slaptažodis turėtų būti atskiras ir naudojamas tik API autentifikacijai.
1 žingsnis: atnaujinkite savo paskyrą į perpardavėjo lygį API prieiga skirta NiceNIC perpardavėjų naudotojams. Jei jūsų paskyra dar nėra atnaujinta, prisijunkite prie savo NiceNIC paskyros ir peržiūrėkite perpardavėjo atnaujinimo galimybes. Perpardavėjo paskyra naudinga, jei narite:
Gauti prieigą prie perpardavėjo lygio domenų kainų
Valdyti daugiau domenų vienoje paskyroje
Naudoti API automatizavimą domenų operacijoms
Prijungti WHMCS arba kitą apskaitos sistemą
Kurti pasikartojančias pajamas iš savo klientų bazės
Po perpardavėjo atnaujinimo galite tęsti API konfigūracijos procesą.
Pasiruošę automatizuoti domenų paslaugas? Pasnaujinkite savo paskyrą į NiceNIC perpardavėjo lygį ir prijunkite domenų registraciją, atnaujinimą, perleidimą, DNS ir WHMCS darbo eigas per Reseller API v2.
2 žingsnis: atidarykite API nustatymus savo NiceNIC paskyroje Po paskyros atnaujinimo į perpardavėjo lygį, prisijunkite į savo NiceNIC paskyrą ir eikite į skyrių Platintojas. Ten raskite API nustatymų sritį. Čia konfigūruosite API prieigą savo perpardavėjo paskyrai. Šioje srityje paprastai turite užpildyti du pagrindinius nustatymus:
Nustatyti API slaptažodį
Įtraukti IP adresą, leidžiamą prieigai prie API
Jei jūsų paskyroje nematote API nustatymų, patikrinkite, ar perpardavėjo atnaujinimas buvo baigtas, arba susisiekite su NiceNIC palaikymu dėl paskyros peržiūros.
3 žingsnis: nustatykite atskirą API slaptažodį Jūsų API slaptažodis turėtų skirtis nuo jūsų NiceNIC paskyros prisijungimo slaptažodžio. Tai svarbu tiek dėl saugumo, tiek dėl trikčių šalinimo. Jei naudosite neteisingą slaptažodį arba naudojate paskyros prisijungimo slaptažodį vietoje API slaptažodžio, autentifikavimas gali nepavykti. Rekomenduojama praktika:
Naudoti stiprų API slaptažodį
Nenaudoti savo paskyros prisijungimo slaptažodžio pakartotinai
Saugojiet API kredencialus saugiai
Nesiųskite API kredencialų per nesaugų pokalbį ar viešus bilietus
Sukeiskite kredencialus, kai kūrėjas, pardavėjas ar buvęs darbuotojas nebereikia prieigos
4 žingsnis: įtraukite savo serverio IP adresą į baltąjį sąrašą Nerint gauti prieigą prie NiceNIC API, būtinas IP adresas, iš kurio bus siunčiamos API užklausos. Paprastai tai yra viešasis jūsų serverio, WHMCS diegimo, apskaitos sistemos ar programos backend'o IP adresas.
Prieš išsaugodami API nustatymus, patikrinkite teisingą išeinančio IP adresą su savo kūrėju ar prieglobos tiekėju. Jei pridėsite netinkamą IP adresą, jūsų API užklausa gali nepavykti, net jei vartotojo vardas ir API slaptažodis teisingi.
Dažnos problemos, susijusios su IP:
Svetainės serverio IP adresas skiriasi nuo išeinančio API užklausos IP
WHMCS yra talpinamas už ugniasienės, proxy ar NAT vartų
Prieglobos paslaugų teikėjas pakeitė serverio IP
Keli serveriai siunčia API užklausas, bet tik vienas IP įtrauktas į baltąjį sąrašą
Kūrimo serveris veikia, bet gamybinis serveris nėra baltajame sąraše
5 žingsnis: prisijunkite prie NiceNIC API v2 galutinio taško Po to, kai jūsų API slaptažodis ir IP baltasis sąrašas bus sukonfigūruoti, jūsų sistema galės siųsti užklausas NiceNIC API v2 galutiniam taškui. API naudoja HTTP užklausas ir grąžina JSON atsakymus. Jūsų užklausa turi turėti reikiamus autarizacijos ir turinio tipo antraštes.
Tiksli užklausos struktūra priklauso nuo API veiksmo, kurį narite atlikti. Pavyzdžiui, domeno prieinamumo tikrinimas, domeno registracija, domeno atnaujinimas, nameserverių atnaujinimas ar sąskaitos balanso patikrinimas gali reikalauti skirtingų parametrų.
Visada vadovaukitės naujausia NiceNIC API v2 dokumentacija kurdami ar atnaujindami integraciją.
Reikia techninės dokumentacijos? Naudokite oficialią NiceNIC Reseller API v2 dokumentaciją, kad peržiūrėtumėte autentifikaciją, atsako kodus, domenų veiksmus, DNS veiksmus, apskaitos veiksmus ir WHMCS palaikymą.
6 žingsnis: pirmiausia išbirykite saugų API veiksmą Prieš pradėdami mokamus ar klientams skirtus veiksmus, pirmiausia išbirykite mažos rizikos API veiksmą.
Rekomenduojami pirmieji testai:
Patikrinti sąskaitos balansą
Patikrinti domeno prieinamumą
Gauti domeno kainodarą
Išvardyti domenus
Venkite pradėti nuo tiesioginės domenų registracijos ar perleidimo, kol nepatvirtinsite, kad autentifikacija, IP baltasis sąrašas, užklausų farmatas ir atsakymų apdarojimas veikia tinkamai.
Jūsų kūrėjas turėtų registruoti šiuos dalykus birymų metu:
Užklausos laiko žymą
API veiksmą
Teste naudotą domeno vardą arba objektą
Užklausų parametrus, išskyrus jautrius duomenis
Passakymo kodą
Passakymo pranešimą
Bet kokią API grąžintą klaidą
Neregistruokite pilnų API kredencialų paprastuoju tekstu.
7 žingsnis: prijunkite WHMCS, jei naudojate WHMCS apmokėjimus Jei jūsų verslas naudoja WHMCS, jums gali nereikėti kurti visų darbo eigų nuo nulio.
NiceNIC siūlo WHMCS integraciją domenų registratariaus operacijoms. Tai gali padėti automatizuoti įprastas perpardavėjo darbo eigas, tokias kaip domenų prieinamumo patikrinimas, registracija, atnaujinimas, perleidimas ir domenų infarmacijos gavimas.
WHMCS integracija ypač naudinga:
Prieglobos įmonėms, parduodančioms domenus su prieglobos paketais
Perpardavėjams, kurie turi automatizuotą klientų apskaitą
Dažnos nustatymo problemos ir kaip jas išspręsti 1. Autentifikacijos klaida Autentifikacijos klaida dažniausiai reiškia, kad API kredencialai arba prieigos nustatymai neteisingi. Patikrinkite:
Patvirtinkite, kad jūsų paskyra turi perpardavėjo prieigą
Patvirtinkite, kad naudojate API slaptažodį, o ne paskyros prisijungimo slaptažodį
Patikrinkite, ar API slaptažodis įvestas teisingai
Patvirtinkite, kad jūsų užklausoje yra Autharization antraštė
Patvirtinkite, kad jūsų serverio IP adresas yra baltajame sąraše API nustatymuose
Patikrinkite, ar užklausa siunčiama iš kito išeinančio IP adreso
2. IP adresas neleistinas arba ryšys nepavyksta Jei jūsų IP adresas neleidžiamas, API užklausa gali nepavykti prieš apdarojant veiksmą.
Prašykite savo prieglobos tiekėjo ar serverio administratariaus patvirtinti tikrą išeinančio API užklausos IP ir tada atnaujinkite API nustatymus savo NiceNIC paskyroje.
3. Neteisingas užklausos farmatas Jei užklausos turinys, antraštė ar parametrai neteisingi, API gali grąžinti klaidos atsakymą. Patikrinkite:
Content-Tipas nustatytas į application/json
Užklausos turinys yra galiojantis JSON
Įtraukti visi reikalingi parametrai
Domeno farmatas yra teisingas
Veiksmo pavadinimas atitinka API dokumentaciją
4. Domeno registracija nepavyko Domeno registravimo užklausa gali nepavykti dėl priežasčių, nesusijusių tiesiogiai su API ryšiu. Galimos priežastys:
Domenas nebėra prieinamas
TLD turi specialius registracijos reikalavimus
Registras reikalauja papildomų dokumentų
Sąskaitos likutis nepakankamas
Domeno kontaktinė infarmacija yra neišsami arba netinkama
Registras atmetė užklausą
Peržiūrėkite API atsakymo pranešimą ir patikrinkite, ar plėtiniu taikomi specialūs registro reikalavimai.
5. Pasnaujinimas arba perleidimas nepavyko Pasnaujinimo ir perleidimo veiksmai gali priklausyti nuo domeno plėtinio, domeno būsenos, registro taisyklių, galiojimo termino, perleidimo užrakinimo, EPP kodo ir sąskaitos likučio.
Dėl perleidimo problemų patikrinkite:
Domenas yra tinkamas perleidimui
Domenas yra atrakintas dabartiniame registre
EPP kodas yra teisingas
Domenas nėra užblokuotas dėl registro ar politikos apribojimų
Registranto el. pašto adresas arba perleidimo patvirtinimo procesas yra užbaigtas, jei reikia
Ką gali ir ko negali atlikti NiceNIC NiceNIC suteikia API prieigą iš registratariaus pusės, perpardavėjo paskyros įrankius, API dokumentaciją, WHMCS integracijos išteklius ir palaikymą domenų operacijoms, kurios galimos per jų platfarmą.
Tačiau kai kurios domenų operacijos priklauso nuo registro taisyklių, plėtinių politikos, patvirtinimo statuso, mokėjimų statuso, piktnaudžiavimo / atitikties statuso ar trečiųjų šalių sistemų.
Pavyzdžiui:
Kai kurie TLD gali reikalauti specialių dokumentų prieš registraciją
Kai kurie domenai gali būti užrakinti, pasibaigę, tikrinimo metu arba apriboti registro politikos
Kai kurie perleidimo prašymai gali reikalauti pralaimėjusio registro arba registranto kontaktų patvirtinimo
DNS pakeitimams gali prireikti laiko išplitimui pasauliniu mastu
WHMCS elgesys taip pat gali priklausyti nuo jūsų WHMCS versijos, modulio nustatymų, serverio aplinkos ir cron konfigūracijos
Dėl šių priežasčių jūsų integracija turėtų visada skaityti ir saugoti API atsakymą, o ne manyti, kad kiekvienas veiksmas yra sėkmingas.
Rekomenduojama pirmoji integracijos darbo eiga Jei kuriate naują integraciją, naudokite šią seką:
Pasnaujinkite į perpardavėjo paskyrą
Konfigūruokite API slaptažodį ir IP baltąjį sąrašą
Įjunkite tiesioginę registraciją, atnaujinimą ir perleidimo darbo eigas tik po testavimo
DUK 1. Ar man reikia perpardavėjo paskyros, kad galėčiau naudotis NiceNIC Reseller API v2? Taip. NiceNIC Reseller API v2 yra skirtas tinkamiems perpardavėjams. Jei negalite pasiekti API nustatymų, patikrinkite, ar jūsų paskyra atnaujinta į perpardavėjo lygį.
2. Ar galiu naudoti savo NiceNIC paskyros prisijungimo slaptažodį kaip API slaptažodį? Ne. Dėl saugumo ir tinkamos konfigūracijos jūsų API slaptažodis turėtų skirtis nuo paskyros prisijungimo slaptažodžio.
3. Kodėl mano API užklausa grąžina autentifikacijos klaidą? Autentifikacijos klaidos dažniausiai sukelia neteisingas API slaptažodis, trūkstama Autharization antraštė, neteisingas vartotojo vardas, IP, kuris nėra baltajame sąraše, arba užklausa siunčiama iš kito išeinančio serverio IP.
4. Ar galiu naudoti NiceNIC API v2 su WHMCS? Taip. NiceNIC teikia WHMCS integraciją domenų registratariaus operacijoms, tokioms kaip prieinamumo patikrinimas, registracija, atnaujinimas, perleidimas ir domenų infarmacijos gavimas.
5. Ar galiu per API registruoti visus domenų plėtinius? Ne visada. Domenų registracija priklauso nuo TLD prieinamumo, registro taisyklių, sąskaitos likučio, patvirtinimo reikalavimų ir plėtinių specifinių apribojimų. Kai kurie TLD gali reikalauti papildomų dokumentų arba rankinės peržiūros.
6. Ką turėčiau išbiryti prieš pradedant naudoti gyvai? Pradėkite nuo mažos rizikos veiksmų, tokių kaip sąskaitos likučio patikrinimas, domeno prieinamumo tikrinimas, kainų patikrinimas ir domenų sąrašo gavimas. Nesileiskite į tiesioginius klientų užsakymus tol, kol nesiimsite autentifikacijos, IP baltojo sąrašo, užklausų farmato, atsakymų apdarojimo ir apskaitos logikos patvirtinimo.
Pradėkite automatizuoti domenų paslaugas su NiceNIC NiceNIC Reseller API v2 suteikia perpardavėjams, prieglobos paslaugų teikėjams, kūrėjams ir WHMCS naudotojams tiesioginį būdą automatizuoti domenų paiešką, registraciją, atnaujinimą, perleidimą, DNS ir paskyros darbo eigas.