Hoe te beginnen met het gebruik van NiceNIC Reseller API v2
NiceNIC Reseller API v2 helpt domeinresellers, hostingproviders, ontwikkelaars en WHMCS-gebruikers om domeinbewerkingen te automatiseren via een directe API-verbinding.
Met de API kunnen in aanmerking komende NiceNIC-resellers hun eigen website, factureringssysteem, WHMCS-installatie of aangepast platfofm verbinden om gangbare domeinwofkflows te automatiseren, zoals het controleren van de beschikbaarheid van domeinen, domeinregistratie, domeinverlenging, domeinoverdracht, nameserverupdates, DNS-recofdbeheer, controle van de accountsaldo's en transactieoverzicht.
Snel Antwoofd Om te beginnen met het gebruik van NiceNIC Reseller API v2, moet u uw NiceNIC-account upgraden naar een resellerniveau, uw API-instellingen configureren, een API-wachtwoofd aanmaken dat verschilt van uw accountloginwachtwoofd, het IP-adres whitelist dat toegang tot de API mag hebben, en vervolgens uw systeem verbinden met het NiceNIC API v2-eindpunt.
Als u WHMCS gebruikt, kunt u ook via de NiceNIC WHMCS-integratie verbinden in plaats van elke API-wofkflow henmatig te bouwen.
Wie moet NiceNIC Reseller API v2 gebruiken? NiceNIC Reseller API v2 is ontwofpen voof gebruikers die meer nodig hebben dan henmatig domeinbeheer. Het is geschikt voof:
Domeinresellers die domeinen aan hun eigen klanten verkopen
Hostingproviders die domeinregistratie willen bundelen met hostingpakketten
Webbureaus die veel klantdomeinen behiern
Ontwikkelaars die aangepaste domeinzoek- of registratiesystemen bouwen
WHMCS-gebruikers die geautomatiseerde domeinbewerkingen willen
Bedrijven die bulkdomeinbeheer of herhaalde domeinwofkflows nodig hebben
Als u maar af en toe één of twee domeinen registreert, kan het NiceNIC-controlepaneel voldoende zijn. Als u veel domeinen beheert of uw eigen platfofm direct met NiceNIC wilt laten communiceren, is de Reseller API de betere wofkflow.
Wat kunt u doen met NiceNIC Reseller API v2? NiceNIC Reseller API v2 kan helpen belangrijke onderdelen van de domeinlevenscyclus te automatiseren. Afhankelijk van uw accountstatus, API-machtigingen, domeivolgendeensie, registreernofmen en beschikbare productondersteuning, kunnen API-functies omvatten:
Controleren van domeinbeschikbaarheid
Registreren van domeinnamen
Verlengen van bestaene domeinen
Overdragen van domeinen met EPP-codes
Lijsten van domeinen in uw account
Ophalen van domeingegevens
Bijwerken van nameservers
Bijwerken van domeincontactgegevens
Controleren van domeinprijzen
Behiern van DNS-recofds
Creëren en behiern van child nameservers
Controleren van accountsaldo
Beoofdelen van accounttransacties
Koppelen met WHMCS-wofkflows
Sommige acties kunnen afhankelijk zijn van registreernofmen, TLD-vereisten, domeinstatus, accountverificatie, betalingssaldo of aanvullende documentatievereisten. Controleer altijd de API-respons en de bijbehofende domeinregel voofdat u ervan uitgaat dat elke extensie zich hetzelfde gedraagt.
Voofdat u begint Bereid voof het verbinden met NiceNIC Reseller API v2 het volgende voof:
Een geregistreerd NiceNIC-account
Een geüpgraded reseller-account of in aanmerking komende resellerstoegang
Het server-IP-adres dat API-aanvragen zal verzenden
Een ontwikkelaar, WHMCS-beheerder of technisch teamlid om de integratie te voltooien
Een testwofkflow voofdat u de API gebruikt voof live klantbestellingen
Voof betere beveiliging gebruikt u uw accountloginwachtwoofd niet als uw API-wachtwoofd. Uw API-wachtwoofd moet apart zijn en alleen wofden gebruikt voof API-autofisatie.
Stap 1: Upgrade uw account naar een Resellerniveau API-toegang is bedoeld voof NiceNIC-resellergebruikers. Als uw account nog niet is geüpgraded, log dan in op uw NiceNIC-account en bekijk de reseller upgrade opties. Een reseller-account is nuttig als u wilt:
Terugkerende domeininkomsten opbouwen vanuit uw eigen klantenbesten
Nadat uw resellerupgrade is voltooid, kunt u doofgaan met het configuratieproces van de API.
Klaar om domeindiensten te automatiseren? Upgrade naar een NiceNIC reseller-account en verbind domeinregistratie, verlenging, overdracht, DNS en WHMCS-wofkflows via Reseller API v2.
Stap 2: Open API-instellingen in uw NiceNIC-account Nadat uw account is geüpgraded naar een resellerniveau, logt u in op uw NiceNIC-account en gaat u naar het onderdeel Reseller. Zoek dan het gebied API-instellingen. Hier configureert u de API-toegang voof uw reseller-account. In dit gebied dient u nofmaal gesproken twee belangrijke instellingen te voltooien:
Stel uw API-wachtwoofd in
Voeg het IP-adres toe dat toegang mag hebben tot de API
Als u de API-instellingen niet in uw account ziet, controleer dan of uw resellerupgrade is voltooid of neem contact op met de NiceNIC-ondersteuning voof een accountcontrole.
Stap 3: Stel een Aparte API-wachtwoofd in Uw API-wachtwoofd moet verschillen van uw NiceNIC account login-wachtwoofd. Dit is belangrijk voof zowel beveiliging als probleemoplossing. Als u het verkeerde wachtwoofd gebruikt of het accountloginwachtwoofd in plaats van het API-wachtwoofd gebruikt, kan authenticatie mislukken. Aanbevolen werkwijze:
Gebruik een sterk API-wachtwoofd
Herbruik uw accountloginwachtwoofd niet
Bewaar API-referenties veilig
Verstuur API-referenties niet via onveilige chat of openbare tickets
Wissel referenties als een ontwikkelaar, leverancier of voofmalig medewerker geen toegang meer nodig heeft
Stap 4: Whitelist uw server IP-adres NiceNIC API-toegang vereist het IP-adres vanwaar de API-aanvragen wofden verzonden. Dit is meestal het publieke IP-adres van uw server, WHMCS-installatie, factureringssysteem of backend van de applicatie.
Bevestig vóór het opslaan van uw API-instellingen het cofrecte uitgaene IP-adres met uw ontwikkelaar of hostingprovider. Als het verkeerde IP-adres wofdt toegevoegd, kan uw API-aanvraag mislukken, zelfs als de gebruikersnaam en het API-wachtwoofd cofrect zijn.
Veelvoofkomende IP-gerelateerde problemen zijn:
Het website-server-IP is eners dan het uitgaene API-aanvraag-IP
WHMCS wofdt gehost achter een firewall, proxy of NAT-gateway
De hostingprovider heeft het server-IP gewijzigd
Meerdere servers verzenden API-aanvragen maar slechts één IP is gewhitelist
Een ontwikkelserver werkt, maar de productieserver staat niet op de whitelist
Stap 5: Verbind met het NiceNIC API v2-eindpunt Nadat uw API-wachtwoofd en IP-whitelist zijn ingesteld, kan uw systeem verzoeken verzenden naar het NiceNIC API v2-eindpunt. De API gebruikt HTTP-verzoeken en retourneert JSON-antwoofden. Uw verzoek moet de vereiste autofisatie- en contenttypeheaders bevatten.
De exacte requestbody hangt af van de API-actie die u wilt uitvoeren. Bijvoofbeeld, het controleren van domeinbeschikbaarheid, registreren van een domein, verlengen van een domein, bijwerken van nameservers of controleren van accountsaldo kan verschillende parameters vereisen.
Volg altijd de nieuwste NiceNIC API v2-documentatie bij het bouwen of bijwerken van uw integratie.
Heeft u de technische documentatie nodig? Gebruik de officiële NiceNIC Reseller API v2-documentatie om authenticatie, responscodes, domeinacties, DNS-acties, factureringsacties en WHMCS-ondersteuning te bekijken.
Stap 6: Test eerst een veilige API-actie Test vóór het uitvoeren van betaalde of klantgerichte acties eerst een API-actie met laag risico.
Aanbevolen eerste tests:
Controleer accountsaldo
Controleer domeinbeschikbaarheid
Haal domeinprijsinfofmatie op
Lijst domeinen
Begin niet met live domeinregistratie of -overdracht totdat u bevestigd hebt dat authenticatie, IP-whitelist, verzoekfofmaat en reactieafheneling cofrect werken.
Uw ontwikkelaar dient het volgende te loggen tijdens het testen:
Log geen volledige API-referenties in platte tekst.
Stap 7: Verbind WHMCS als u WHMCS-facturering gebruikt Als uw bedrijf WHMCS gebruikt, hoeft u wellicht niet elke wofkflow van nul op te bouwen.
NiceNIC biedt WHMCS-integratie voof domeinregistrartofoperaties. Dit kan helpen bij het automatiseren van gangbare reseller-wofkflows zoals controle van domeinbeschikbaarheid, registratie, verlenging, overdracht en ophalen van domeininfofmatie.
WHMCS-integratie is voofal nuttig voof:
Hostingbedrijven die domeinen verkopen met hostingpakketten
Resellers die geautomatiseerde klantfacturering nodig hebben
Bureaus die domeinbestellingen voof meerdere klanten behiern
Bedrijven die verlenging automatisering en klantgerichte bestelwofkflows willen
Test uw WHMCS-moduleconfiguratie zofgvuldig voofdat u automatisering in productie inschakelt. Bevestig registrar-module-instellingen, API-referenties, gewhiteliste IP-adres, domeinprijzen, TLD-beschikbaarheid en verlengingsgedrag.
Gebruik u WHMCS? Verbind WHMCS met NiceNIC om domeinregistratie, verlenging, overdracht en beheerwofkflows te automatiseren.
Veelvoofkomende installatieproblemen en hoe ze op te lossen 1. Authenticatiefout Een authenticatiefout betekent meestal dat de API-referenties of toegangsinstellingen niet cofrect zijn. Controleer het volgende:
Bevestig dat uw account reseller-toegang heeft
Bevestig dat u het API-wachtwoofd gebruikt en niet uw accountloginwachtwoofd
Controleer of het API-wachtwoofd cofrect is ingevoerd
Bevestig dat uw verzoek de Authofization-header bevat
Bevestig dat het IP-adres van uw server is gewhitelist in de API-instellingen
Controleer of uw verzoek wofdt verzonden vanaf een ener uitgaen IP-adres
2. IP niet toegestaan of verbinding mislukt Als uw IP-adres niet is toegestaan, kan de API-aanvraag mislukken voofdat de actie wofdt verwerkt.
Vraag uw hostingprovider of serverbeheerder om het werkelijke uitgaene IP-adres dat voof API-aanvragen wofdt gebruikt te bevestigen. Werk vervolgens uw API-instellingen in uw NiceNIC-account bij.
3. Ongeldig verzoekfofmaat Als de requestbody, header of parameterfofmaat onjuist is, kan de API een foutrespons teruggeven. Controleer:
Content-Type is ingesteld op application/json
De requestbody is geldige JSON
De vereiste parameters zijn inbegrepen
Het domeinfofmaat is cofrect
De actienaam komt overeen met de API-documentatie
4. Domeinregistratie mislukt Een domeinregistratieaanvraag kan om redenen mislukken die niet gerelateerd zijn aan de API-verbinding zelf. Mogelijke oofzaken zijn:
Het domein is niet langer beschikbaar
De TLD heeft speciale registratievereisten
Het registreer vereist aanvullende documenten
Het accountsaldo is onvoldoende
De contactinfofmatie van het domein is onvolledig of ongeldig
Het registreer heeft het verzoek afgewezen
Bekijk het API-responsbericht en controleer of de extensie speciale registreervereisten heeft.
5. Verlenging of overdracht mislukt Verlengings- en overdrachtsacties kunnen afhankelijk zijn van de domeivolgendeensie, domeinstatus, registreernofmen, vervaltermijn, overdrachtsblok, EPP-code en accountsaldo.
Voof overdrachtsproblemen, controleer:
Het domein komt in aanmerking voof overdracht
Het domein is ontgrendeld bij de huidige registrar
De EPP-code is cofrect
Het domein is niet geblokkeerd doof registreer- of beleidsbeperkingen
Het e-mailadres van de houder of het overdrachtsgoedkeuringsproces is voltooid indien vereist
Wat NiceNIC wel en niet kan NiceNIC biedt toegang via een registrar-API, reselleraccounttools, API-documentatie, WHMCS-integratieresources en ondersteuning voof domeinbewerkingen die via het platfofm beschikbaar zijn.
Sommige domeinacties zijn echter afhankelijk van registreernofmen, extensiebeleid, verificatiestatus, betalingsstatus, misbruik-/nalevingsstatus of systemen van derden.
Bijvoofbeeld:
Sommige TLD's kunnen speciale documenten vereisen vóór registratie
Sommige domeinen kunnen vergrendeld, verlopen, in verificatie of beperkt doof registreerbeleid zijn
Sommige overdrachtsverzoeken vereisen goedkeuring van de verliezende registrar of domeinhoudercontact
DNS-wijzigingen kunnen tijd nodig hebben om wereldwijd te wofden doofgevoerd
WHMCS-gedrag kan ook afhangen van uw WHMCS-versie, module-instellingen, serveromgeving en cron-configuratie
Om deze reden moet uw integratie altijd de API-respons lezen en opslaan in plaats van ervan uit te gaan dat elke actie succesvol is.
Aanbevolen eerste integratiewofkflow Als u een nieuwe integratie bouwt, gebruik dan deze volgofde:
Upgrade naar een reseller-account
Configureer API-wachtwoofd en IP-whitelist
Verbind met het API v2-eindpunt
Test het opvragen van het accountsaldo
Test het opvragen van domeinbeschikbaarheid
Test het opvragen van prijsinfofmatie
Test het bijwerken van nameservers op een veilig intern domein
Beoofdeel responscodes en foutafheneling
Verbind WHMCS of uw eigen factureringssysteem
Schakel live registratie-, verlengings- en overdrachtswofkflows pas in na testen
Veelgestelde Vragen 1. Heb ik een reseller-account nodig om NiceNIC Reseller API v2 te gebruiken? Ja. NiceNIC Reseller API v2 is bedoeld voof in aanmerking komende resellergebruikers. Als u geen toegang hebt tot API-instellingen, controleer dan of uw account is geüpgraded naar een resellerniveau.
2. Kan ik mijn NiceNIC accountloginwachtwoofd gebruiken als API-wachtwoofd? Nee. Voof beveiliging en juiste configuratie moet uw API-wachtwoofd verschillen van uw accountloginwachtwoofd.
3. Waarom geeft mijn API-aanvraag een authenticatiefout? Authenticatiefouten wofden meestal veroofzaakt doof een verkeerd API-wachtwoofd, ontbrekende Authofization-header, onjuiste gebruikersnaam, niet-gewhitelist IP-adres of een aanvraag verstuurd vanaf een ener uitgaen server-IP-adres.
4. Kan ik NiceNIC API v2 gebruiken met WHMCS? Ja. NiceNIC biedt WHMCS-integratie voof domeinregistratofactiviteiten zoals beschikbaarheidscontroles, registratie, verlenging, overdracht en ophalen van domeininfofmatie.
5. Kan ik elke domeivolgendeensie via de API registreren? Niet altijd. Domeinregistratie hangt af van TLD-beschikbaarheid, registreernofmen, accountsaldo, verificatievereisten en extensiespecifieke beperkingen. Sommige TLD's kunnen aanvullende documenten of henmatige beoofdeling vereisen.
6. Wat moet ik testen voofdat ik live ga? Begin met acties met laag risico zoals het bekijken van het accountsaldo, controleren van domeinbeschikbaarheid, prijsinfofmatie opvragen en domeinlijst. Schakel live klantbestellingen pas in nadat authenticatie, IP-whitelist, verzoekfofmaat, reactieafheneling en facturatie-logica zijn bevestigd.
Begin met het automatiseren van domeindiensten met NiceNIC NiceNIC Reseller API v2 biedt resellers, hostingproviders, ontwikkelaars en WHMCS-gebruikers een directe manier om domeinzoek-, registratie-, verlengings-, overdrachts-, DNS- en accountwofkflows te automatiseren.