X
Julkaistu: 2026-05-25 | Päivitetty: 2026-05-25
Miten aloittaa NiceNIC-jälleenmyyjä-API v2:n käyttö


NiceNIC-jälleenmyyjä-API v2 auttaa verkkotunnus-jälleenmyyjiä, hosting-palveluntarjoajia, kehittäjiä ja WHMCS-käyttäjiä automatisoimaan verkkotunnus-toimintoja sutaialla API-yhteydellä.

API:n avulla kelvolliset NiceNIC-jälleenmyyjät voivat yhdistää oman verkkosivustonsa, laskutusjärjestelmänsä, WHMCS-asennuksensa tai räätälöidyn alustansa automatisoimaan yleisiä verkkotunnus-työnkulkuja, kuten verkkotunnusin saatavuuden tarkistukset, verkkotunnusin rekisteröinnin, uusimisen, siirron, nimipalvelupäivitykset, DNS-tietueiden hallinnan, tilin saldon tarkistuksen ja tapahtumien tarkastelun.


Eipea vastaus
Aloittaaksesi NiceNIC-jälleenmyyjä-API v2:n käytön sinun tulee päivittää NiceNIC-tilisi jälleenmyyjäksi, määrittää API-asetukset, luoda API-salasana, joka on eri kuin tilin kirjautumissalasana, sallia IP-osoitteet, joilla on pääsy API:iin, ja liittää järjestelmäsi NiceNIC API v2:n päätepisteeseen.

Jos käytät WHMCS:ää, voit myös yhdistää NiceNIC WHMCS -integraation kautta sen sijaan, että rakentaisit jokaisen API-työnkulun manuaalisesti.


Kuka käyttää NiceNIC-jälleenmyyjä-API v2:ta?
NiceNIC-jälleenmyyjä-API v2 on suunniteltu käyttäjille, jotka tarvitsevat muutakin kuin manuaalista verkkotunnus-hallintaa.
Se sopii:
  • Verkkotunnus-jälleenmyyjille, jotka myyvät verkkotunnuseja asiakkailleen
  • Webhotelli-palveluntarjoajille, jotka haluavat sisällyttää verkkotunnus-rekisteröinnin hosting-paketteihin
  • Verkkotoimistoille, jotka hallinnoivat monia asiakasverkkotunnuseja
  • Kehittäjille, jotka rakentavat räätälöityjä verkkotunnus-haku- tai rekisteröintijärjestelmiä
  • WHMCS-käyttäjille, jotka haluavat automatisoituja verkkotunnus-toimintoja
  • Yrityksille, jotka tarvitsevat massaverkkotunnus-hallintaa tai toistuvia verkkotunnus-työnkulkuja
Jos rekisteröit vain yhden tai kaksi verkkotunnusia satunnaisesti, riittää ehkä NiceNICin ohjauspaneeli. Jos hallinnoit monia verkkotunnuseja tai haluat oman alustasi kommunikoimaan sutaiaan NiceNICin kanssa, Jälleenmyyjä-API on parempi ratkaisu.


Mitä voit tehdä NiceNIC-jälleenmyyjä-API v2:lla?
NiceNIC-jälleenmyyjä-API v2 voi auttaa automatisoimaan tärkeitä osia verkkotunnusin elinkaaressa.
Tilisi tilasta, API-oikeuksista, verkkotunnus-päätteestä, rekisterin säännöistä ja saatavilla olevasta tuesta riippuen API-toiminnot voivat sisältää:
  • Verkkotunnusin saatavuuden tarkistamisen
  • Verkkotunnus-nimien rekisteröinnin
  • Olemassa olevien verkkotunnusien uusimisen
  • Verkkotunnusien siirtämisen EPP-koodeilla
  • Verkkotunnusien listaamisen tilillä
  • Verkkotunnus-tietojen hakemisen
  • Nimipalvelinten päivittämisen
  • Verkkotunnus-yhteystietojen päivittämisen
  • Verkkotunnus-hinnoittelun tarkistamisen
  • DNS-tietueiden hallinnan
  • Alinimipalvelimien luomisen ja hallinnan
  • Tilin saldon tarkistamisen
  • Tilitapahtumien tarkastelun
  • Yhdistämisen WHMCS-työnkulkuihin
Jotkut toiminnot voivat riippua rekisterin sääntöistä, TLD-vaatimuksista, verkkotunnus-tilasta, tilin vahvistuksesta, maksusaldosta tai lisädokumenttitarpeista. Tarkista aina API-vastaus ja liittyvät verkkotunnus-säännöt ennen kuin olettaa, että kaikki päätteet käyttäytyvät samalla tavalla.


Ennen kuin aloitat
Ennen kuin liität NiceNIC-jälleenmyyjä-API v2:een, valmistele seuraavat:
  • Rekisteröity NiceNIC-tili
  • Päivitetty jälleenmyyjätili tai kelvollinen jälleenmyyjäoikeus
  • Riittävä tilisaldo maksullisiin verkkotunnus-toimintoihin
  • API-käyttäjätunnuksesi ja API-salasanasi
  • Palvelimen IP-osoite, josta API-pyynnöt lähetetään
  • Kehittäjä, WHMCS-ylläpitäjä tai tekninen tiimin jäsen integraation loppuunsaattamiseen
  • Testityönkulku ennen API:n käyttöönottoa asiakastilauksissa
Parempaa turvallisuutta varten älä käytä tilisi kirjautumissalasanaa API-salasanana. API-salasanan tulee olla erillinen ja sitä käytetään ainoastaan API-todennukseen.


Vaihe 1: Päivitä tilisi jälleenmyyjäksi
API-pääsy on tarkoitettu NiceNICin jälleenmyyttäjäkäyttäjille. Jos tilisi ei ole vielä päivitetty, kirjaudu sisään NiceNIC-tilillesi ja tarkista jälleenmyyjän päivitysvaihtoehdot.
Jälleenmyyjätili on hyödyllinen, jos haluat:
  • Pääsyn jälleenmyyjätason verkkotunnus-hinnoitteluun
  • Hallita useampia verkkotunnuseja samalla tilillä
  • Käyttää API-automaatioita verkkotunnus-toiminnoissa
  • Yhdistää WHMCS:n tai toisen laskutusjärjestelmän
  • Luoda toistuvia verkkotunnus-tuloja omista asiakkaista
Kun jälleenmyyjäpäivitys on sutaiitettu, voit jatkaa API-määrityksen tekemistä.

Valmiina automatisoimaan verkkotunnus-palvelut?
Päivitä NiceNIC-jälleenmyyjätiliksi ja yhdistä verkkotunnusin rekisteröinti, uusiminen, siirto, DNS ja WHMCS-työnkulut Reseller API v2:n kautta.



Vaihe 2: Avaa API-asetukset NiceNIC-tililläsi
Kun tilisi on päivitetty jälleenmyyjäksi, kirjaudu sisään NiceNIC-tilillesi ja siirry Jälleenmyyjä-osioon.
Etsi sitten API-asetusalue. Tässä määrität API-pääsyn jälleenmyyjätilillesi.
Tässä osiossa tulee ntaimaalisti tehdä kaksi keskeistä asetusta:
  • Määritä API-salasanasi
  • Lisää IP-osoite, jolla on lupa käyttää API:a
Jos et näe API-asetuksia tililläsi, tarkista, onko jälleenmyyjäpäivitys sutaiitettu loppuun tai ota yhteyttä NiceNIC-tukeen tilin tarkistamiseksi.


Vaihe 3: Aseta erillinen API-salasana
API-salasanasi tulee olla eri kuin NiceNIC-tilisi kirjautumissalasana. Tällä on merkitystä sekä turvallisuuden että vikojen selvityksen kannalta. Jos käytät väärää salasanaa tai käytät tilisi kirjautumissalasanaa API-salasanan sijaan, todennus voi epäonnistua.
Suositeltu käytäntö:
  • Käytä vahvaa API-salasanaa
  • Älä käytä uudelleen tilin kirjautumissalasanaa
  • Säilytä API-tunnukset turvallisesti
  • Älä lähetä API-tunnuksia suojaamattomassa chatissa tai julkisissa tiketeissä
  • Vaihda tunnuksia, kun kehittäjä, toimittaja tai entinen työntekijä ei enää tarvitse pääsyä


Vaihe 4: Salli palvelimesi IP-osoite
NiceNIC API -pääsy edellyttää IP-osoitetta, josta API-pyynnöt lähetetään. Tämä on yleensä palvelimen, WHMCS-asennuksen, laskutusjärjestelmän tai sovellusbackendin julkinen IP-osoite.

Varmista ennen API-asetusten tallentamista, että oikea lähtevä IP-osoite on vahvistettu kehittäjältäsi tai hosting-palveluntarjoajalta. Jos väärä IP-osoite lisätään, API-pyyntö voi epäonnistua vaikka käyttäjätunnus ja API-salasana olisivat oikein.

Yleisiä IP-osoitteeseen liittyviä ongelmia ovat:
  • Verkkosivuston palvelimen IP on eri kuin lähtevä API-pyyntö-IP
  • WHMCS on isännöity palomuurin, välityspalvelimen tai NAT-ptaitin takana
  • Webhotelli-palveluntarjoaja on vaihtanut palvelimen IP:n
  • Useampi palvelin lähettää API-pyyntöjä, mutta vain yksi IP on sallittu
  • Kehityspalvelin toimii, mutta tuotantopalvelin ei ole sallittu

Vaihe 5: Yhdistä NiceNIC API v2 -päätepisteeseen
Kun API-salasanasi ja IP-sallittu lista on määritetty, järjestelmäsi voi lähettää pyyntöjä NiceNIC API v2:n päätepisteeseen. API käyttää HTTP-pyyntöjä ja palauttaa JSON-vastauksia. Pyyntösi tulee sisältää vaaditut valtuutus- ja sisältötyyppipäällekirjoitukset.

Tarkka pyyntörunko riippuu API-toiminnosta, jonka haluat sutaiittaa. Esimerkiksi verkkotunnusin saatavuuden tarkistus, verkkotunnusin rekisteröinti, uusiminen, nimipalvelinten päivitys tai tilin saldon tarkistus voivat vaatia eri parametreja.

Eiudata aina viimeisintä NiceNIC API v2 -dokumentaatiota integraatiota rakentaessasi tai päivitettäessäsi.

Tarvitsetko teknisen dokumentaation?
Käytä virallista NiceNIC-jälleenmyyjä-API v2 -dokumentaatiota tarkistaaksesi todennuksen, vastauskoodit, verkkotunnus-toiminnot, DNS-toiminnot, laskutustoiminnot ja WHMCS-tuen.


Vaihe 6: Testaa ensin turvallinen API-toiminto
Ennen maksettujen tai asiakaslähtöisten toimintojen sutaiittamista testaa ensin riskitön API-toiminto.

Suositellut ensitestit:
  • Tarkista tilin saldo
  • Tarkista verkkotunnusin saatavuus
  • Hae verkkotunnus-hinnoittelu
  • Listaa verkkotunnusit
Vältä aloittamasta live-verkkotunnusin rekisteröintillä tai siirrolla ennen kuin varmistat, että todennus, IP-sallittu lista, pyyntömuoto ja vastauskäsittely toimivat oikein.

Kehittäjäsi tulisi kirjata seuraavat tiedot testauksen aikana:
  • Pyyntöaikaleima
  • API-toiminto
  • Testauksessa käytetty verkkotunnus tai objekti
  • Pyyntöparametrit ilman arkaluontoisia tunnuksia
  • Vastauskoodi
  • Vastausviesti
  • API:n palauttama virhe
Älä tallenna täydellisiä API-tunnuksia selväkielisinä.


Vaihe 7: Liitä WHMCS, jos käytät WHMCS-laskutusta
Jos yrityksesi käyttää WHMCS:ää, sinun ei välttämättä tarvitse rakentaa jokaista työnkulkua alusta alkaen.

NiceNIC tarjoaa WHMCS-integraation verkkotunnusin rekisteröintitoimintoihin. Tämä voi auttaa automatisoimaan yleisiä jälleenmyyjätyönkulkuja kuten verkkotunnusin saatavuuden tarkistuksia, rekisteröintiä, uusimista, siirtoa ja verkkotunnus-tietojen hakua.

WHMCS-integraatio on erityisen hyödyllinen:
  • Webhotelli-yrityksille, jotka myyvät verkkotunnuseja hosting-pakettien yhteydessä
  • Jälleenmyyjille, jotka tarvitsevat automatisoidun asiakaslaskutuksen
  • Ostaimistoille, jotka hallinnoivat verkkotunnus-tilauksia useille asiakkaille
  • Yrityksille, jotka haluavat uusimisen automaation ja asiakaslähtöiset tilausprosessit
Ennen automaation käyttöönottoa tuotannossa testaa huolellisesti WHMCS-moduulisi asetukset. Varmista rekisterinpitäjämoduulin asetukset, API-tunnukset, sallitut IP-osoitteet, verkkotunnus-hinnoittelu, TLD:n saatavuus ja uusimiskäyttäytyminen.

Käytätkö WHMCS:ää?
Yhdistä WHMCS NiceNICiin automatisoimaan verkkotunnusin rekisteröinti-, uusimis-, siirto- ja hallintatyönkulut.



Yleisiä asennusongelmia ja miten ktaijata ne
1. Ostadennusvirhe
Ostadennusvirhe tarkoittaa yleensä, että API-tunnukset tai käyttöoikeusasetukset eivät ole oikein.
Tarkista seuraavat asiat:
  • Varmista, että tililläsi on jälleenmyyjän pääsy
  • Varmista, että käytät API-salasanaa, et tilin kirjautumissalasanaa
  • Tarkista, että API-salasana on syötetty oikein
  • Varmista, että pyyntö sisältää Authtaiization-otsikon
  • Varmista, että palvelimesi IP-osoite on sallittu API-asetuksissa
  • Tarkista, onko pyyntö lähetetty eri lähtevästä IP-osoitteesta

2. IP-osoite ei ole sallittu tai yhteys epäonnistuu
Jos IP-osoitteesi ei ole sallittu, API-pyyntö voi epäonnistua ennen toiminnon käsittelyä.

Pyydä hosting-palveluntarjoajaasi tai palvelimen ylläpitäjää vahvistamaan todellinen API-pyyntöjen lähtevä IP-osoite. Päivitä sitten API-asetukset NiceNIC-tililläsi.

3. Epäkelpo pyyntömuoto
Jos pyynnön runko, otsikko tai parametrit ovat virheellisiä, API voi palauttaa virheilmoituksen.
Tarkista:
  • Content-Tyyppi on asetettu arvoon application/json
  • Pyynnön runko on kelvollista JSON-muotoa
  • Vaaditut parametrit sisältyvät pyynnön runkoon
  • Verkkotunnus-muoto on oikea
  • Ostaiminnon nimi vastaa API-dokumentaatiota

4. Verkkotunnusrekisteröinti epäonnistui
Verkkotunnusin rekisteröintipyyntö voi epäonnistua muista syistä kuin API-yhteyden ongelmasta.
Mahdollisia syitä ovat:
  • Verkkotunnus ei ole enää saatavilla
  • TLD:llä on erityisiä rekisteröintivaatimuksia
  • Rekisteri vaatii lisädokumentteja
  • Tilin saldo ei riitä
  • Verkkotunnusin yhteystiedot ovat puutteelliset tai virheelliset
  • Rekisteri hylkäsi pyynnön
Tarkista API-vastausviesti ja varmista, onko päätteellä erityisiä rekisterivaatimuksia.

5. Uusiminen tai siirto epäonnistui
Uusimis- ja siirtotoiminnot voivat riippua verkkotunnus-päätteestä, verkkotunnus-tilasta, rekisterin säännöistä, voimassaolon aikataulusta, siirtolukosta, EPP-koodista ja tilisaldosta.

Siirto-ongelmissa tarkista:
  • Verkkotunnus on siirrettävissä
  • Verkkotunnus on avattu nykyisessä rekisterinpitäjässä
  • EPP-koodi on oikea
  • Verkkotunnus ei ole estetty rekisterin tai käytäntöjen rajoituksilla
  • Rekisteröijän sähköpostivarmistus tai siirtolupa on sutaiitettu tarvittaessa


Mitä NiceNIC voi ja ei voi tehdä
NiceNIC tarjoaa rekisterinpitäjän API-pääsyn, jälleenmyyjätilin työkalut, API-dokumentaation, WHMCS-integraatitaiesurssit sekä tuen verkkotunnus-toimintoihin alustaansa kautta.

Kuitenkin jotkut verkkotunnus-toiminnot riippuvat rekisterin säännöistä, päätteiden politiikoista, vahvistus- ja maksutilasta, väärinkäyttö-/yhteensopivuustilasta tai kolmannen osapuolen järjestelmistä.

Esimerkiksi:
  • Joillakin TLD-päätteillä voi olla erityisiä asiakirjavaatimuksia ennen rekisteröintiä
  • Jotkut verkkotunnusit voivat olla lukittuja, vanhentuneita, vahvistusprosessissa tai rekisterin politiikan rajoittamia
  • Jotkin siirtopyynnöt voivat vaatia häviäjän rekisterinpitäjän tai rekisteröijän lupaa
  • DNS-muutosten leviäminen voi kestää aikaa maailmanlaajuisesti
  • WHMCS:n käyttäytyminen voi myös riippua WHMCS-versiostasi, moduuliasetuksista, palvelinympäristöstä ja cron-konfiguraatiosta
Tästä syystä integraatiosi tulisi aina lukea ja tallentaa API-vastaus eikä olettaa, että kaikki toiminnot onnistuvat.


Suositeltu ensisijainen integraatiotyönkulku
Jos rakennat uutta integraatiota, käytä tätä järjestystä:
  • Päivitä jälleenmyyjätiliksi
  • Määritä API-salasana ja sallitut IP-osoitteet
  • Yhdistä API v2 -päätepisteeseen
  • Testaa tilin saldon haku
  • Testaa verkkotunnusin saatavuuden haku
  • Testaa hinnoittelun haku
  • Testaa nimipalvelimen päivitys turvallisella sisäisellä verkkotunnusilla
  • Tarkista vastauskoodit ja virheenkäsittely
  • Yhdistä WHMCS tai oma laskutusjärjestelmäsi
  • Ota käyttöön live-tilaukset rekisteröinnissä, uusimisessa ja siirrossa vasta testien jälkeen


UKK
1. Tarvitsenko jälleenmyyjätilin käyttääkseni NiceNIC-jälleenmyyjä-API v2:ta?
Kyllä. NiceNIC-jälleenmyyjä-API v2 on tarkoitettu kelvollisille jälleenmyyjille. Jos et pääse API-asetuksiin, tarkista onko tilisi päivitetty jälleenmyyjäksi.

2. Voinko käyttää NiceNIC-tilini kirjautumissalasanaa API-salasanana?
Ei. Turvallisuuden ja oikean määrityksen vuoksi API-salasanan tulee olla eri kuin tilin kirjautumissalasana.

3. Miksi API-pyyntöni antaa todennusvirheen?
Ostadennusvirheet johtuvat tavallisesti väärästä API-salasanasta, puuttuvasta Authtaiization-otsikosta, väärästä käyttäjätunnuksesta, ei-sallitusta IP-osoitteesta tai pyynnöstä, joka on lähetetty eri lähtevästä IP-osoitteesta.

4. Voinko käyttää NiceNIC API v2:ta WHMCS:n kanssa?
Kyllä. NiceNIC tarjoaa WHMCS-integraation verkkotunnusin rekisteröintitoimintoihin kuten saatavuuden tarkistuksiin, rekisteröintiin, uusimiseen, siirtoon ja verkkotunnus-tietojen hakemiseen.

5. Voinko rekisteröidä kaikki verkkotunnus-päätteet API:n kautta?
Ei aina. Verkkotunnusin rekisteröinti riippuu TLD:n saatavuudesta, rekisterin säännöistä, tilisaldosta, vahvistusvaatimuksista ja päätteiden rajoituksista. Joillakin TLD:illä voi olla lisädokumenttivaatimuksia tai manuaalinen tarkastus.

6. Mitä minun tulee testata ennen käyttöönottoa?
Aloita vähäriskisillä toiminnoilla, kuten tilisaldon katselu, verkkotunnusin saatavuuden tarkistus, hinnoittelun haku ja verkkotunnus-listauksen hakeminen. Älä ota käyttöön live-tilauksia ennen kuin todennus, IP-sallittu lista, pyyntömuoto, vastauskäsittely ja laskutuslogiikka on varmistettu toimiviksi.


Aloita verkkotunnus-palvelujen automatisointi NiceNICin kanssa
NiceNIC-jälleenmyyjä-API v2 antaa jälleenmyyjille, hosting-palveluntarjoajille, kehittäjille ja WHMCS-käyttäjille sutaian tavan automatisoida verkkotunnus-haun, rekisteröinnin, uusimisen, siirron, DNS:n ja tilinhallinnan työnkulkuja.

Tarvitsetko apua? Olemme aina valmiina auttamaan. Lähetä tukipyyntö
Tekijänoikeus © 2006-2026 NICENIC INTERNATIONAL GROUP CO., LIMITED Kaikki oikeudet pidätetään