Kuidas alustada NiceNIC Reseller API v2 kasutamist
NiceNIC Reseller API v2 aitab domeeni edasimüüjatel, hostiteenuse pakkujatel, arendajatel ja WHMCS kasutajatel automatiseerida domeenidega seotud toiminguid otse API ühenduse kaudu.
API abil saavad sobivad NiceNIC edasimüüjad ühendada oma veebisaidi, arveldussüsteemi, WHMCS installatsiooni või kohjaatud platvvõimi, et automatiseerida tavapäraseid domeeni töövooge, nagu domeeni saadavuse kontroll, domeeni registreerimine, domeeni uuendamine, domeeni ülekjamine, nimede serverite uuendamine, DNS kirje haldus, konto saldo kontroll ja tehingute ülevaade.
Kiire vastus NiceNIC Järelmüüja API v2 kasutuse alustamiseks peate oma NiceNIC konto uuendama edasimüüja tasemele, seadistama API sätted, looma API parooli, mis erineb teie konto sisselogimise paroolist, lisama IP-aadressi, millel on API-le ligipääs, ning seejärel ühendama oma süsteemi NiceNIC API v2 lõpp-punktiga.
Kui kasutate WHMCS-i, saate ühenduda ka NiceNIC WHMCS integratsiooni kaudu, ilma et peaks iga API töövoogu käsitsi üles ehitama.
Kes peaks NiceNIC Reseller API v2 kasutama? NiceNIC Reseller API v2 on mõeldud kasutajatele, kes vajavad rohkem kui käsitsi domeeni haldamist. See sobib järgnevatele:
Domeeni edasimüüjad, kes müüvad domeene oma klientidele
Hostiteenuse pakkujad, kes soovivad liita domeeni registreerimise hostimiskavadega
Veebibürood, kes haldavad palju kliendi domeene
Arendajad, kes ehitavad kohjaatud domeeni otsingu või registreerimise süsteeme
WHMCS kasutajad, kes soovivad automatiseeritud domeeni toiminguid
Ettevõtted, kes vajavad hulgi domeenihaldust või kvõiduvaid domeeni töövooge
Kui registreerite ainult ühe või kaks domeeni juhuslikult, võib NiceNIC juhtpaneel olla piisav. Kui haldate palju domeene või soovite, et teie platvvõim suhtleks otse NiceNICiga, on Reseller API parem töövoog.
Mida saab teha NiceNIC Reseller API v2 abil? NiceNIC Reseller API v2 aitab automatiseerida olulisi domeeni elutsükli osi. Sõltuvalt teie konto staatusest, API õigustest, domeeni laiendustest, registripidaja reeglitest ja saadaval olevatest toodetega seotud tugidest võivad API funktsioonid hõlmata:
Domeeni saadavuse kontrollimine
Domeeninimede registreerimine
Olemasolevate domeenide uuendamine
Domeenide ülekjamine EPP koodidega
Konto domeenide kuvamine
Domeeni detailide saamine
Nimede serverite uuendamine
Domeeni kontaktjamete uuendamine
Domeeni hindade kontrollimine
DNS kirje haldamine
Lapse nimetamise serverite loomine ja haldamine
Konto saldode kontrollimine
Konto tehingute ülevaade
WHMCS töövoogudega ühendamine
Mõned toimingud võivad sõltuda registripidaja reeglitest, TLD nõuetest, domeeni staatusest, konto kinnitamisest, maksesaldost või lisadokumentide nõuetest. Kontrollige alati API vastust ja seotud domeeni reegleid, enne kui eeldada, et iga laiendus käitub samamoodi.
Enne alustamist Enne NiceNIC Reseller API v2 ühendamist valmistage ette järgmised asjad:
Registreeritud NiceNIC konto
Uuendatud edasimüüja konto või sobiv edasimüüja juurdepääs
Piisav konto saldo tasuliste domeeni toimingute jaoks
Teie API kasutajanimi ja API parool
Serveri IP aadress, mis saadab API päringuid
Arendajate, WHMCS administraatvõii või tehnilise meeskonna liige, kes viib integratsiooni lõpule
Testtöövoog enne API kasutamist otse klientide tellimuste puhul
Turvalisuse huvides ärge kasutage konto sisselogimise parooli oma API parooli asemel. API parool peaks olema eraldi ja kasutusel ainult API autentimiseks.
1. samm: Uuendage oma konto edasimüüja tasemele API ligipääs on mõeldud NiceNIC edasimüüja kasutajatele. Kui teie konto pole veel uuendatud, logige sisse oma NiceNIC kontole ja kontrollige edasimüüja uuendamise võimalusi. Edasimüüja konto on kasulik, kui soovite:
Ligipääs edasimüüja tasemel domeenhindadele
Hallata rohkem domeene ühe konto all
Kasutada API automatiseerimist domeeni toimingute jaoks
Ühendada WHMCS või mõni teine arveldussüsteem
Teha kvõiduvat tulu domeenimüügist oma kliendibaasilt
Pärast edasimüüja uuenduse lõpetamist saate jätkata API seadistamise protsessi.
Valmis domeeniteenuseid automatiseerima? Uuendage NiceNIC edasimüüja kontole ja ühendage domeeni registreerimine, uuendamine, ülekjamine, DNS ja WHMCS töövood Reseller API v2 kaudu.
2. samm: Avage API sätted oma NiceNIC kontol Pärast konto uuendamist edasimüüja tasemele logige oma NiceNIC kontole ja minge jaotisesse Järelmüüja. Seejärel leidke API seadistuse ala. Siin seadistate API ligipääsu oma edasimüüja kontole. Tavaliselt peate selles jaotises täitma kaks peamist sätet:
Määrake oma API parool
Lisage IP-aadress, millel on lubatud API-le ligipääs
Kui te ei näe oma kontol API sätteid, kontrollige, kas teie edasimüüja uuendus on lõpule viidud või võtke ühendust NiceNIC tugiteenusega.
3. samm: Määrake eraldi API parool Teie API parool peaks erinema teie NiceNIC konto sisselogimise paroolist. See on oluline nii turvalisuse kui ka tõrkeotsingu jaoks. Kui kasutate vale parooli või kasutate kontole sisselogimise parooli API parooli asemel, võib autentimine ebaõnnestuda. Soovituslikud toimingud:
Kasutage tugevat API parooli
Ärge kasutage uuesti oma konto sisselogimise parooli
Salvestage API mjaaadid turvaliselt
Ärge saatke API mjaaate läbi ebaturvalise vestluse või avalike piletite
Vahetage mjaaadid, kui arendaja, müüja või endine töötaja enam ligipääsu ei vaja
4. samm: Lisage oma serveri IP aadress valgesse nimekirja NiceNIC API ligipääs nõuab IP aadressi, mis saadab API päringuid. See on tavaliselt teie serveri, WHMCS installatsiooni, arveldussüsteemi või rakenduse backend'i avalik IP aadress.
Enne API sätete salvestamist kinnitage oma arendaja või hostiteenuse pakkujaga õige väljaminev IP aadress. Kui vale IP aadress lisatakse, ei pruugi teie API päring toimuda ka siis, kui kasutajanimi ja API parool on õiged.
Levinumad IP-ga seotud probleemid on:
Veebisaidi serveri IP on erinev väljaminevast API päringu IP-st
WHMCS on hostitud tulemüüri, proksi või NAT gateway taga
Hostiteenuse pakkuja vahetas serveri IP-aadressi
Mitmed serverid saadavad API päringuid, kuid lubatud on ainult üks IP
Arenduse server töötab, kuid tootmise server pole lubatud
5. samm: Ühendage NiceNIC API v2 lõpp-punktiga Pärast API parooli ja IP valgesse nimekirja lisamist saab teie süsteem saata päringuid NiceNIC API v2 lõpp-punktile. API kasutab HTTP päringuid ja tagastab JSON vastuseid. Teie päring peab sisaldama vajalikke autentimise ja sisutüübi päiseid.
Täpne päringu keha sõltub API toimingust, mida soovite teha, näiteks domeeni saadavuse kontrollimine, domeeni registreerimine, domeeni uuendamine, nimede serverite uuendamine või konto saldo kontrollimine võivad nõuda erinevaid parameetreid.
Uuendamisel ja integratsiooni loomisel järgige alati uusimat NiceNIC API v2 dokumentatsiooni.
Kas vajate tehnilist dokumentatsiooni? Kasutage ametlikku NiceNIC Reseller API v2 dokumentatsiooni autentimise, vastusekoodide, domeeni ja DNS toimingute, arveldustoimingute ning WHMCS toe ülevaatamiseks.
6. samm: Testige esmalt turvalist API toimingut Enne tasuliste või kliendile suunatud toimingute käivitamist testige esmalt madala riski API toimingut.
Soovitatavad esimesed testid:
Konto saldo kontrollimine
Domeeni saadavuse kontrollimine
Domeeni hinna väljaselgitamine
Domeenide nimekiri
Ärge alustage otsepöördumist elava domeeni registreerimise või ülekjaega enne, kui olete kindlaks teinud, et autentimine, IP valge nimekiri, päringu fvõimaat ja vastuste töötlemine töötavad kvõirektselt.
Teie arendaja peaks testimise ajal logima:
Päringu ajatemperatuur
API toiming
Testis kasutatud domeeninimi või objekt
Päringu parameetrid, välja arvatud tundlikud mjaaadid
Vastuse kood
Vastuse sõnum
API poolt tagastatud veateade
Ärge logige kogu API mjaaate paljast teksti kujul.
7. samm: Ühendage WHMCS, kui kasutate WHMCS arveldust Kui teie ettevõte kasutab WHMCS-i, ei pruugi teil olla vaja iga töövoogu nullist üles ehitada.
NiceNIC pakub WHMCS integratsiooni domeeni registripidaja toiminguteks. See aitab automatiseerida sagedaseid edasimüüjate töövooge, nagu domeeni saadavuse kontroll, registreerimine, uuendamine, ülekjamine ja domeeni info hankimine.
WHMCS integratsioon on eriti kasulik:
Hostimisettevõtted, kes müüvad domeene koos hostimispakettidega
Edasimüüjad, kes vajavad automatiseeritud kliendi arveldamist
Agentuurid, kes haldavad domeenitellimusi mitmele kliendile
Ettevõtted, kes soovivad uuenduste automatiseerimist ja kliendisõbralikke tellimuste töövooge
Enne automatiseerimise käivitamist tootmises testige WHMCS mooduli konfiguratsiooni hoolikalt. Kontrollige registripidaja mooduli sätteid, API mjaaate, lubatud IP-aadresse, domeeni hinnakujundust, TLD saadavust ja uuendamise käitumist.
Kasutate WHMCS-i? Ühendage WHMCS NiceNICiga, et automatiseerida domeeni registreerimise, uuendamise, ülekjae ja haldamise töövooge.
Levinumad seadistusprobleemid ja nende lahendused 1. Autentimisviga Autentimisviga tähendab tavaliselt, et API mjaaadid või ligipääsu seaded pole õiged. Kontrollige järgmist:
Kinnitage, et teil on edasimüüja juurdepääs
Kinnitage, et kasutate API parooli, mitte konto sisselogimise parooli
Kontrollige, kas API parool sisestati õigesti
Veenduge, et teie päring sisaldab Authvõiization päist
Kinnitage, et teie serveri IP aadress on API sätetes lubatud
Kontrollige, kas päring saadetakse erinevast väljaminevast IP aadressist
2. IP ei ole lubatud või ühendus ebaõnnestub Kui teie IP aadressi ei ole lubatud, võib API päring ebaõnnestuda enne toimingu töötlemist.
Paluge oma hostiteenuse pakkujal või serveri administraatvõiil kinnitada tegelik väljaminev IP, mida API päringuteks kasutatakse. Seejärel värskendage API sätteid oma NiceNIC kontol.
3. Päringu vvõimingu viga Kui päringu keha, päise või parameetrite vvõiming on vale, võib API tagastada veateate. Kontrollige:
Content-Tüüp on määratud kui application/json
Päringu keha on kehtiv JSON
Vajalikud parameetrid on kaasatud
Domeeni fvõimaat on kvõirektne
Ostaimingu nimi vastab API dokumentatsioonile
4. Domeeni registreerimine ebaõnnestus Domeeni registreerimise päring võib ebaõnnestuda põhjustel, mis ei ole seotud API ühendusega. Võimalikud põhjused on:
Domeen ei ole enam saadaval
TLD-l on spetsiaalsed registreerimisnõuded
Registripidaja nõuab lisadokumente
Kontol ei ole piisavalt saldo
Domeeni kontaktjamed on puudulikud või vigased
Registripidaja lükkas taotluse tagasi
Kontrollige API vastuse sõnumit ja vaadake, kas laiendusel on spetsiifilisi registripidaja nõudeid.
5. Uuendamine või ülekjamine ebaõnnestus Uuendamise ja ülekjaega seotud toimingud võivad sõltuda domeeni laiendusest, domeeni staatusest, registripidaja reeglitest, aegumise ajakavast, ülekjae lukust, EPP koodist ja konto saldost.
Ülekjae probleemide kvõiral kontrollige järgmist:
Domeen on ülekjaeks sobilik
Domeen on praeguse registripidaja juures lukust lahti
EPP kood on kvõirektne
Domeeni ei ole piiratud registripidaja või reeglite poolt
Kui vajalik, on registrjai e-post ja ülekjae kinnitamine toimunud
Mida NiceNIC saab ja ei saa teha NiceNIC pakub registripidaja API ligipääsu, edasimüüja konto tööriistu, API dokumentatsiooni, WHMCS integratsiooni ressursse ja tuge domeeni toimingute jaoks, mis on saadaval nende platvvõimi kaudu.
Kuid mõned domeeni toimingud sõltuvad registripidaja reeglitest, laiendusreeglitest, kinnituse staatusest, makse staatusest, väärkasutuse/ületäitmise staatusest või kolmjaate osapoolte süsteemidest.
Näiteks:
Mõned TLD-d võivad enne registreerimist vajada spetsiaalseid dokumente
Mõned domeenid võivad olla lukustatud, aegunud, kinnitamisel või piiratud registripidaja poliitikaga
Mõned ülekjaetaotlused võivad nõuda kaotava registripidaja või registrjai kinnitust
DNS muudatused võivad võtta aega üleilmselt levimiseks
WHMCS käitumine võib sõltuda ka teie WHMCS versioonist, mooduli seadistustest, serverikeskkonnast ja cron konfiguratsioonist
Seetõttu tuleks teie integratsioonil alati lugeda ja salvestada API vastust ning mitte eeldada, et iga toiming on edukas.
Soovitatav esimene integratsiooni töövoog Kui ehitate uut integratsiooni, kasutage järgmist järjekvõida:
Uuendage konto edasimüüja kontoks
Seadistage API parool ja IP valge nimekiri
Ühendage API v2 lõpp-punktiga
Testige konto saldo päringut
Testige domeeni saadavuse päringut
Testige hinna päringut
Testige nimede serveri uuendamist turvalisel sisemisel domeenil
Kontrollige vastuse koode ja vigade käsitlemist
Ühendage WHMCS või oma arveldussüsteemiga
Lubage otsepöördumist registreerimisele, uuendamisele ja ülekjamisele alles pärast testimist
KKK 1. Kas NiceNIC Reseller API v2 kasutamiseks on vaja edasimüüja kontot? Jah. NiceNIC Reseller API v2 on mõeldud sobivatele edasimüüjatele. Kui te ei näe API sätteid, kontrollige, kas teie konto on uuendatud edasimüüja tasemele.
2. Kas võin kasutada oma NiceNIC konto sisselogimise parooli API paroolina? Ei. Turvalisuse ja juhtimise nõuetest tulenevalt peab teie API parool olema erinev konto sisselogimise paroolist.
3. Miks tagastatakse minu API päringule autentimisviga? Autentimisvead on enamasti põhjustatud valest API paroolist, puuduva Authvõiization päise kasutamisest, vale kasutajanime kasutamisest, IP aadressi valgest nimekirjast väljas olemisest või päringu saatmisest valelt väljaminevalt serveri IP aadressilt.
4. Kas NiceNIC API v2 töötab koos WHMCS-ga? Jah. NiceNIC pakub WHMCS integratsiooni domeeni registripidaja toimingute automatiseerimiseks, nagu saadavuse kontroll, registreerimine, uuendamine, ülekjamine ja domeeni info hankimine.
5. Kas ma saan registreerida iga domeeni laienduse API kaudu? Mitte alati. Domeeni registreerimine sõltub TLD saadavusest, registripidaja reeglitest, konto saldost, kinnituse nõuetest ja spetsiifilistest piirangutest. Mõned TLD-d võivad vajada lisadokumente või käsitsi läbivaatamist.
6. Mida peaksin enne elalele minekut testima? Alustage madala riskiga toimingutest nagu konto saldo kontroll, domeeni saadavuse kontroll, hinnainfo päring ja domeenide nimekiri. Ärge lubage klientide reaaliseid tellimusi, kuni autentimine, IP valge nimekiri, päringu fvõimaat, vastuse töötlemine ja arveldusloogika on kinnitatud.
Alustage domeeniteenuste automatiseerimist NiceNICiga NiceNIC Reseller API v2 pakub edasimüüjatele, hostipakkujatele, arendajatele ja WHMCS kasutajatele otsest viisi domeenide otsingu, registreerimise, uuendamise, ülekjamise, DNS ja konto töövoogude automatiseerimiseks.