Naudodami „NiceNIC“ domenų API v2, kūrėjai gali patikrinti domenų prieinamumą ir kainas, registruoti ir atnaujinti domenus, teikti gaunamus perkėlimus, tvarkyti vardų serverius ir DNS įrašus, bei gauti domenų portfelio informaciją per autentifikuotus HTTPS užklausas.
Prieš naudodami tikras domenų operacijas, kūrėjai gali išbandyti autentifikaciją, užklausas, atsakymus ir programų logiką „NiceNIC“ API smėlio dėžėje.
Jei vis dar svarstote, ką automatizuoti, žr. „Ką galite padaryti su domenų registratoriaus API? 10 praktinių automatizavimo darbo eigų“.
Saugiausias integracijos kelias yra paprastas:
Autentifikacija → Prieinamumas → Kainos → Atsakymų apdorojimas → Tiesioginės operacijos
Kaip veikia domenų registratoriaus API integracija?
Tipiška integracija sujungia keturias dalis:
Jūsų programa → API užklausa → Registratoriaus apdorojimas → Struktūruotas atsakymas
„NiceNIC“ domenų API v2 naudoja HTTPS užklausas ir JSON atsakymus.
Dabartinis gamybos API galutinis taškas yra:
https://api.NiceNIC/v2/
Autentifikacijai naudojamas jūsų „NiceNIC“ vartotojo vardas ir API slaptažodis „Authorization“ antraštėje:
Authorization: username:api_secret
Content-Type: application/json
Tipiškas atsakymas turi:
-
code -
msg -
data
Kūrėjai turėtų peržiūrėti dabartinę API autentifikacijos dokumentaciją prieš siųsdami gamybos užklausas.
Ką turėtumėte išbandyti prieš atlikdami tiesiogines domenų API užklausas?
Neatlikite tiesioginės registracijos kaip savo pirmojo API bandymo.
Saugesnė tvarka yra:
Tai padeda rasti autentifikacijos ar atsakymų apdorojimo problemas, kol jos dar neturi įtakos tikram domeno užsakymui.
Kaip patikrinti domeno prieinamumą per API?
Domeno prieinamumas yra viena geriausių pirmųjų užklausų kūrėjui.
Paprasta darbo eiga atrodo taip:
Vartotojas įveda domeną → programa siunčia API užklausą → registratorius grąžina prieinamumą → programa rodo rezultatą
„NiceNIC“ Domeno prieinamumo tikrinimo API palaiko programinį patikrinimą palaikomų domenų, įskaitant kelis domenų vardus vienoje prieinamumo užklausoje.
Tai gali suteikti galių:
- Domenų paieškos įrankiams
- Hostingo registracijos puslapiams
- Svetainių kūrimo įrankiams
- SaaS programoms
- Vidinėms pavadinimų priemonėms
Kadangi užklausa nesukuria domeno užsakymo, ji taip pat naudinga tikrinant autentifikaciją ir atsakymų analizę prieš pereinant prie mokamų operacijų.
Kaip gauti domeno registracijos, atnaujinimo ir perkėlimo kainas per API?
Nemanau, kad registracijos, atnaujinimo ir perkėlimo kainos yra vienodos.
Programos, kurios rodo ar naudoja domenų kainas, turėtų gauti dabartines kainas, o ne neribotą laiką pasikliauti užkoduota reikšme.
„NiceNIC“ Domeno kainų gavimo API palaiko užklausas dėl:
- Registracijos kainų
- Atnaujinimo kainų
- Perkėlimo kainų
- Visų palaikomų kainų tipų
Registracijos kainų atsakymai taip pat gali nurodyti, ar užklaustas domenas yra premium.
Dažna darbo eiga yra:
Patikrinti prieinamumą → gauti dabartinę kainą → rodyti ar patvirtinti kainą → tęsti
API prieiga ir kainų lygis yra atskiri. Užklausos naudoja kainas, taikomas „NiceNIC“ paskyrai, kuri siunčia jas.
Kaip užregistruoti domeną per API?
Kai autentifikacija, prieinamumas, kainos ir atsakymų apdorojimas veikia tinkamai, galite pridėti domeno registraciją.
Tipiška eiga yra:
Domenas pasirinktas → kaina patikrinta → registranto informacija patvirtinta → registracija pateikta → atsakymas apdorotas
„NiceNIC“ Domeno registracijos API palaiko programinę registraciją palaikomiems domenams.
Tai gali būti naudinga dėl:
- Hostingo atsiskaitymo sistemų
- Svetainių kūrimo įrankių
- Klientų portalų
- SaaS platformų
- Vidinių domeno užsakymo sistemų
Tačiau API nepašalina registro reikalavimų.
Skirtingi TLD gali turėti skirtingus registracijos laikotarpius, kontaktų reikalavimus, tinkamumo taisykles ar patvirtinimo reikalavimus. Jūsų programa turėtų patikrinti atitinkamus reikalavimus, o ne manyti, kad kiekvienas plėtinys elgiasi vienodai būdu.
Ar galite atnaujinti ir perkelti domenus per registratoriaus API?
Taip, kai atitinkamos operacijos yra palaikomos.
„NiceNIC“ pateikia dokumentuotą Domeno atnaujinimo API palaikomiems atnaujinimams.
Atnaujinimo darbo eiga galėtų būti:
Domenas artėja prie galiojimo pabaigos → vidinė politika patikrinta → atnaujinimas patvirtintas → API užklausa pateikta → rezultatas užfiksuotas
„NiceNIC“ taip pat pateikia Domeno perkėlimo į API palaikomiems gaunamiems perkėlimams.
Perkėlimams reikia atsargiau tvarkyti būseną valdymą.
Perkėlimas gali priklausyti nuo:
- Perkėlimo tinkamumo
- Auth/EPP kodo
- Dabartinės domeno būsenos
- Registratoriaus apdorojimo
- Registro apdorojimo
Taigi teisingas modelis yra:
Pateikti → skaityti atsakymą → stebėti būseną → tvarkyti išimtis
ne:
Pateikti → manyti, kad perkėlimas baigtas
Ar galite tvarkyti DNS ir vardų serverius per domeno API?
Taip.
„NiceNIC“ domenų API v2 apima atskiras operacijas dėl:
- Autoritetingų vardų serverių atnaujinimo
- DNS įrašų sąrašo
- DNS įrašų kūrimo
- DNS įrašų atnaujinimo
- DNS įrašų šalinimo
- Vaikinių vardų serverių valdymo
Pavyzdžiui, hostingo platforma galėtų naudoti darbo eigą, tokią kaip:
Domenas užregistruotas → hostingas sukonfigūruotas → DNS šablonas pasirinktas → reikalingi įrašai sukurti
Vienas skirtumas yra svarbus:
Vardų serveriai nustato, kur yra perduodamas autoritetingas DNS delegavimas.
DNS įrašai yra įrašai DNS zonoje.
Vaikiniai vardų serveriai yra pagrindiniai/klijų įrašai, tokie kaip ns1.example.com.
Tai skirtingos operacijos ir neturėtų būti laikomos keičiamomis.
Ar galite gauti domenų portfelio duomenis per API?
Taip.
Registratoriaus API taip pat gali gauti informaciją, o ne tik pateikti užsakymus.
„NiceNIC“ domenų API v2 palaiko domenų sąrašo ir atskirų domenų išsamios informacijos operacijas, kurios gali būti naudojamos :
- Portfelio informacijos suvestinėse
- Klientų portaluose
- Vidinėse administravimo sistemose
- Stebėjimo įrankiuose
- Turto valdymo platformose
Pavyzdžiui:
Tai leidžia programai sujungti registratoriaus informaciją su verslo kontekstu, kurio reikia jūsų organizacijai .
Ką reiškia domeno API atsakymo kodai?
Sėkmingas HTTP ryšys ne visada reiškia, kad prašoma domeno operacija yra baigta.
„NiceNIC“ šiuo metu dokumentuoja atsakymų būsenas , įskaitant:
0
201
400
401
404
500
Jūsų programa turėtų patikrinti ir grąžintą kodą, ir msg.
Tai ypač svarbu registracijoms ir perkėlimams.
Ką reiškia 201 laukiantis API atsakymas?
201 atsakymas reiškia, kad operacija buvo priimta apdorojimui, bet nebūtinai pasiekė galutinę būseną.
Pavyzdžiui, registracijos užklausa vis dar gali laukti galutinio registro apdorojimo.
Perkėlimas taip pat gali likti laukiantis, kol registratorius ar registras tęsia apdorojimą.
Nerodykite klientui, kad domeno operacija baigta tik todėl, kad užklausa buvo priimta.
Jūsų programa turėtų išlaikyti laukiančią būseną, kol galutinis rezultatas bus patvirtintas.
Ar „NiceNIC“ turi domeno API smėlio dėžę testavimui?
Taip.
„NiceNIC“ API smėlio dėžė yra skirta kūrimui ir integracijos testavimui prieš gamybą.
Kūrėjai gali ją naudoti testavimui:
- Autentifikacijos
- Užklausų formatavimo
- Atsakymų analizės
- Klaidų tvarkymo
- Galutinės programos logikos
Smėlio dėžės operacijos nesukuria tikrų domeno užsakymų ar realių mokesčių.
Smėlio dėžė naudoja atskirą API slaptažodį ir galutinį tašką:
https://sandbox-api.NiceNIC/v2/
Praktinis kelias yra:
Smėlio dėžės testavimas → gamybos autentifikacija → mažos rizikos gamybos užklausa → tiesioginės domeno operacijos
Kurias programavimo kalbas galite naudoti su domeno registratoriaus API?
Bet kuri serverio pusės programavimo kalba arba vykdymo aplinka, galinti siųsti HTTPS užklausas ir analizuoti JSON, gali integruotis su „NiceNIC“ domenų API v2.
Dažni pasirinkimai:
- PHP
- Python
- Node.js
- Java
Svarbus reikalavimas yra ne programavimo kalba.
Tai yra API prisijungimo duomenų laikymas patikimoje serverio pusės aplinkoje, o ne API slaptažodžio atskleidimas naršyklės JavaScript, viešose saugyklose ar atsisiunčiamame kliento kode.
Ar yra užklausų skaičiaus apribojimai domeno API užklausoms?
Gali būti taikomi užklausų skaičiaus apribojimai, siekiant apsaugoti API stabilumą ir platformos saugumą.
Kūrėjai neturėtų manyti, kad projektuojant didelės apimties sistemas yra neribotas užklausų pralaidumas.
Jei jūsų gamybos integracija turėtų generuoti nuolatinį didelį užklausų kiekį, susisiekite su „NiceNIC“ prieš paleidimą, kad numatomas naudojimo modelis būtų peržiūrėtas.
Tai ypač aktualu dėl:
- Didelių prieinamumo darbo krūvių
- Masinių portfelio operacijų
- Didelės apimties hostingo platformų
- Automatizuotų foninių procesų
Ką kūrėjai turėtų patikrinti prieš pradėdami veikti?
Prieš įgalindami gamybos registracijas, atnaujinimus, perkėlimus ar DNS pakeitimus, patvirtinkite , kad:
- API prisijungimo duomenys lieka serverio pusėje.
- Dabartinės kainos tikrinamos prieš kainoms jautrius užsakymus.
- Sėkmės, laukiančios ir klaidų būsenos apdorojamos atskirai.
- TLD specifiniai reikalavimai yra patvirtinti.
- Svarbūs domeno veiksmai yra registruojami.
- Jūsų sistema netraktuoja priimtos užklausos kaip automatiškai baigtos.
Testavimo tikslas yra ne tik priversti API grąžinti atsakymą.
Tai yra užtikrinti, kad jūsų programa teisingai apdoroja visą domeno darbo eigą .
Kur kūrėjai gali pradėti su „NiceNIC“ domenų API v2?
Pradėkite nuo „NiceNIC“ domenų API v2 dokumentacijos ir pasirinkite vieną paprastą darbo eigą.
Daugeliui kūrėjų protingas pradžios taškas yra:
Autentifikacija → Domeno prieinamumas → Kainos
Tada išbandykite atsakymų apdorojimą prieš įgalindami:
Registraciją → Atnaujinimą → Perkėlimą → DNS
Jei norite išbandyti nesukuriant tikrų domeno užsakymų, pradėkite „NiceNIC“ API smėlio dėžėje.
Dėl platesnių klausimų apie prieigą, kainas, klaidas ir integraciją žr. „Kaip naudoti domeno registratoriaus API? 28 klausimai apie prieigą, kainas, klaidas ir integraciją“.
Geriausia API integracija yra ne ta, kuri automatizuoja daugiausiai operacijų.
Tai ta, kuri paverčia tinkamas pasikartojančias domeno užduotis patikimais programinės įrangos darbo eigos procesais.
