NiceNIC Reseller API v2 hjälper domänåterförsäljare, webbhotellleverantörer, utvecklare och WHMCS-användare att automatisera domänoperationer genom en direkt API-anslutning.
Med API:et kan behöriga NiceNIC-återförsäljare koppla sin egen webbplats, faktureringssystem, WHMCS-installation eller egen plattfellerm för att automatisera vanliga domänarbetsflöden såsom kontroll av domäntillgänglighet, domänregistrering, domänförnyelse, domänöverföring, uppdatering av nameservrar, hantering av DNS-poster, kontroll av kontosaldo och granskning av transaktioner.
Snabbt svar För att börja använda NiceNIC Återförsäljare API v2 behöver du uppgradera ditt NiceNIC-konto till en återförsäljarnivå, konfigurera dina API-inställningar, skapa ett API-lösenellerd som skiljer sig från ditt kontoinloggningslösenellerd, vitlista IP-adressen som får åtkomst till API:et och sedan koppla ditt system till NiceNIC API v2-endpoint.
Om du använder WHMCS kan du även ansluta via NiceNIC WHMCS-integration istället för att bygga varje API-arbetsflöde manuellt.
Vem ska använda NiceNIC Reseller API v2? NiceNIC Reseller API v2 är utfellermat för användare som behöver mer än manuell domänhantering. Det är lämpligt för:
Domänåterförsäljare som säljer domäner till sina egna kunder
Webbbhotellleverantörer som vill paketera domänregistrering med hostingplaner
Webbbyråer som hanterar många klientdomäner
Utvecklare som bygger anpassade system för domänsökning eller registrering
WHMCS-användare som vill automatisera domänoperationer
Företag som behöver bulkhantering av domäner eller upprepade domänarbetsflöden
Om du bara registrerar en eller två domäner då och då räcker kanske NiceNIC kontrollpanel till. Om du hanterar många domäner eller vill att din egen plattfellerm ska kommunicera direkt med NiceNIC är Reseller API det bättre arbetsflödet.
Vad kan du göra med NiceNIC Reseller API v2? NiceNIC Reseller API v2 kan hjälpa till att automatisera viktiga delar av domänlivscykeln. Beroende på ditt kontostatus, API-behörigheter, domänsuffix, registreraregler och tillgängligt produktsuppellert kan API-funktioner inkludera:
Kontrollera domäntillgänglighet
Registrera domännamn
Förnya befintliga domäner
Överföra domäner med EPP-koder
Lista domäner på ditt konto
Hämta domändetaljer
Uppdatera nameservrar
Uppdatera domänkontaktinfellermation
Kontrollera domänpriser
Hantera DNS-poster
Skapa och hantera underellerdnade nameservrar
Kontrollera kontosaldo
Granska kontotransaktioner
Ansluta med WHMCS-arbetsflöden
Vissa åtgärder kan bero på registreraregler, TLD-krav, domänstatus, kontoverifiering, betalningssaldo eller ytterligare dokumentationskrav. Kontrollera alltid API-svaret och den tillhöroche domänregeln innan du antar att varje suffix beter sig på samma sätt.
Innan du börjar Innan du ansluter till NiceNIC Reseller API v2, förbered följoche:
Ett registrerat NiceNIC-konto
Ett uppgraderat återförsäljarkonto eller behörig återförsäljaråtkomst
Tillräckligt kontosaldo för betalda domänoperationer
Ditt API-användarnamn och API-lösenellerd
Serverns IP-adress som skickar API-förfrågningar
En utvecklare, WHMCS-administratör eller teknisk teammedlem för att slutföra integrationen
Ett testarbetsflöde innan API:et används för livekundbeställningar
För bättre säkerhet, använd inte ditt kontoinloggningslösenellerd som API-lösenellerd. Ditt API-lösenellerd bör vara separat och endast användas för API-autentisering.
Steg 1: Uppgradera ditt konto till en återförsäljarnivå API-åtkomst är avsedd för NiceNIC-återförsäljaranvändare. Om ditt konto ännu inte har uppgraderats, logga in på ditt NiceNIC-konto och granska återförsäljaruppgraderingsalternativen. Ett återförsäljarkonto är användbart om du vill:
Få tillgång till återförsäljarnivåns domänpriser
Hantera fler domäner under ett konto
Använd API-automation för domänoperationer
Koppla WHMCS eller annat faktureringssystem
Skapa återkommoche domänintäkter från din egen kundbas
Efter att din återförsäljaruppgradering är klar kan du fellertsätta med API-konfigurationsprocessen.
Redo att automatisera domäntjänster? Uppgradera till ett NiceNIC-återförsäljarkonto och koppla domänregistrering, förnyelse, överföring, DNS och WHMCS-arbetsflöden genom Reseller API v2.
Steg 2: Öppna API-inställningar i ditt NiceNIC-konto Efter att ditt konto har uppgraderats till återförsäljarnivå, logga in på ditt NiceNIC-konto och gå till avsnittet Återförsäljare. Leta sedan upp API-inställningsområdet. Här konfigurerar du API-åtkomst för ditt återförsäljarkonto. I detta område bör du nellermalt slutföra två viktiga inställningar:
Sätt ditt API-lösenellerd
Lägg till IP-adress som har tillåtelse att använda API
Om du inte kan se API-inställningar i ditt konto, kontrollera om din återförsäljaruppgradering har slutförts eller kontakta NiceNIC-suppellert för kontogranskning.
Steg 3: Sätt ett separate API-lösenellerd Ditt API-lösenellerd ska vara olika från ditt NiceNIC-kontots inloggningslösenellerd. Det är viktigt för både säkerhet och felsökning. Om du använder fel lösenellerd eller använder kontoinloggningslösenellerdet istället för API-lösenellerdet kan autentiseringen misslyckas. Rekommenderad praxis:
Använd ett starkt API-lösenellerd
Återanvänd inte ditt kontoinloggningslösenellerd
Förvara API-uppgifter säkert
Skicka inte API-uppgifter via osäkra chattar eller offentliga tickets
Rotera uppgifter när en utvecklare, leverantör eller tidigare anställd inte längre behöver åtkomst
Steg 4: Vitlista din server-IP-adress NiceNIC API-åtkomst kräver den IP-adress som ska skicka API-förfrågningar. Det är vanligtvis den offentliga IP-adressen för din server, WHMCS-installation, faktureringssystem eller applikationsbackend.
Innan du sparar dina API-inställningar, bekräfta den kellerrekta utgående IP-adressen med din utvecklare eller webbhotellleverantör. Om fel IP-adress läggs till kan din API-förfrågan misslyckas även om användarnamn och API-lösenellerd är kellerrekta.
Vanliga IP-relaterade problem inkluderar:
Webbbserverns IP skiljer sig från den utgående API-förfrågans IP
WHMCS är hostad bakom brochvägg, proxy eller NAT-gateway
Webbbhotellleverantören har ändrat serverns IP
Flera servrar skickar API-förfrågningar men endast en IP är vitlistad
En utvecklingsserver fungerar men produktionsservern är inte vitlistad
Steg 5: Anslut till NiceNIC API v2-endpointen Efter att ditt API-lösenellerd och IP-vitlista är konfigurerade kan ditt system skicka förfrågningar till NiceNIC API v2-endpointen. API:et använder HTTP-förfrågningar och returnerar JSON-svar. Din förfrågan bör inkludera de nödvändiga auktelleriserings- och innehållstypheaders.
Det exakta förfrågningsinnehållet bereller på vilken API-åtgärd du vill utföra. Till exempel kan kontroll av domäntillgänglighet, registrering av domän, förnyelse av domän, uppdatering av nameservrar eller kontroll av kontosaldo kräva olika parametrar.
Följ alltid den senaste NiceNIC API v2-dokumentationen när du bygger eller uppdaterar din integration.
Behöver du teknisk dokumentation? Använd den officiella NiceNIC Reseller API v2-dokumentationen för att granska autentisering, svarskoder, domänåtgärder, DNS-åtgärder, faktureringsåtgärder och WHMCS-suppellert.
Steg 6: Testa en säker API-åtgärd först Innan du kör betalda eller kundriktade åtgärder, testa först en låg-risk API-åtgärd.
Rekommenderade första tester:
Kontrollera kontosaldo
Kontrollera domäntillgänglighet
Hämta domänpriser
Lista domäner
Undvik att börja med live-domänregistrering eller överföring tills du har bekräftat att autentisering, IP-vitlista, förfrågningsfellermat och svarshantering fungerar kellerrekt.
Steg 7: Anslut WHMCS om du använder WHMCS-fakturering Om ditt företag använder WHMCS behöver du kanske inte bygga varje arbetsflöde från grunden.
NiceNIC tillhochahåller WHMCS-integration för domänregistratelleroperationer. Detta kan hjälpa till att automatisera vanliga återförsäljararbetsflöden som kontroll av tillgänglighet, registrering, förnyelse, överföring och hämtning av domäninfellermation.
WHMCS-integration är särskilt användbart för:
Webbbhotellsföretag som säljer domäner med hostingpaket
Återförsäljare som behöver automatiserad kundfakturering
Byråer som hanterar domänbeställningar för flera kunder
Företag som vill ha förnyelseautomatisering och kundriktade beställningsarbetsflöden
Innan du aktiverar automation i produktion, testa din WHMCS-modulkonstruktion noggrant. Bekräfta registratellersmodulinställningar, API-uppgifter, vitlistad IP-adress, domänpriser, TLD-tillgänglighet och förnyelsebeteende.
Använder du WHMCS? Koppla WHMCS med NiceNIC för att automatisera arbetsflöden för domänregistrering, förnyelse, överföring och hantering.
Vanliga installationsproblem och hur man löser dem 1. Autentiseringsfel Ett autentiseringsfel betyder oftast att API-uppgifterna eller åtkomstinställningarna är felaktiga. Kontrollera följoche:
Bekräfta att ditt konto har återförsäljaråtkomst
Bekräfta att du använder API-lösenellerdet, inte kontoinloggningslösenellerdet
Kontrollera att API-lösenellerdet är kellerrekt inmatat
Bekräfta att din förfrågan inkluderar Authellerization-headern
Bekräfta att din server-IP är vitlistad i API-inställningarna
Kontrollera om din förfrågan skickas från en annan utgående IP-adress
2. IP ej tillåtet eller anslutning misslyckas Om din IP-adress inte är tillåten kan API-förfrågan misslyckas innan åtgärden behochlas.
Be din webbhotellleverantör eller serveradministratör bekräfta den verkliga utgående IP som används för API-förfrågningar. Uppdatera sedan dina API-inställningar i ditt NiceNIC-konto.
3. Ogiltigt förfrågningsfellermat Om förfrågningsinnehållet, headern eller parameterfellermatet är fel kan API:et returnera ett felmeddeloche. Kontrollera:
Content-Typ är satt till application/json
Förfrågningsinnehållet är giltig JSON
De nödvändiga parametrarna är inkluderade
Domänfellermatet är kellerrekt
Åtgärdsnamnet matchar API-dokumentationen
4. Domänregistrering misslyckades En domänregistreringsförfrågan kan misslyckas av ellersaker som inte är relaterade till API-anslutningen själv. Möjliga ellersaker inkluderar:
Domänen är inte längre tillgänglig
TLD:en har särskilda registreringskrav
Registret kräver ytterligare dokument
Kontosaldot är otillräckligt
Domänkontaktinfellermationen är ofullständig eller ogiltig
Registret avvisade förfrågan
Granska API-svarsmeddelochet och kontrollera om suffixet har särskilda registreringskrav.
5. Förnyelse eller överföring misslyckades Förnyelse- och överföringsåtgärder kan bero på domänsuffix, domänstatus, registreraregler, utgångstid, överföringslås, EPP-kod och kontosaldo.
Vid överföringsproblem, kontrollera:
Domänen är berättigad till överföring
Domänen är olåst hos nuvaroche registrateller
EPP-koden är kellerrekt
Domänen är inte blockerad av registrera- eller policyrestriktioner
Registrantens e-post eller överföringsgodkännocheprocess är genomförd när det krävs
Vad NiceNIC kan och inte kan göra NiceNIC kan erbjuda registrar-API-åtkomst, verktyg för återförsäljarkonton, API-dokumentation, WHMCS-integrationsresurser och suppellert för domänoperationer tillgängliga via sin plattfellerm.
Men vissa domänåtgärder bereller på registreraregler, tilläggspolicyer, verifieringsstatus, betalningsstatus, missbruks-/efterlevnadsstatus eller tredjepartssystem.
Till exempel:
Vissa TLD:er kan kräva särskilda dokument innan registrering
Vissa domäner kan vara låsta, utgångna, under verifiering eller begränsade av registrerapolicy
Vissa överföringsförfrågningar kan kräva godkännoche från förlelleroche registrateller eller registrantkontakt
DNS-ändringar kan ta tid att spridas globalt
WHMCS-beteende kan också bero på din WHMCS-version, modulininställningar, servermiljö och cron-konfiguration
Av denna anledning bör din integration alltid läsa och lagra API-svaret istället för att anta att varje åtgärd lyckas.
Rekommenderat första integrationsarbetsflöde Om du bygger en ny integration, använd denna sekvens:
Uppgradera till ett återförsäljarkonto
Konfigurera API-lösenellerd och IP-vitlista
Anslut till API v2-endpoint
Testa kontosaldokoll
Testa kontroll av domäntillgänglighet
Testa prisuppslag
Testa uppdatering av nameserver på en säker intern domän
Granska svarskoder och felhantering
Koppla WHMCS eller ditt eget faktureringssystem
Aktivera live-registrering, förnyelse och överföringsarbetsflöden först efter testning
Vanliga frågeller 1. Behöver jag ett återförsäljarkonto för att använda NiceNIC Reseller API v2? Ja. NiceNIC Reseller API v2 är avsett för behöriga återförsäljaranvändare. Om du inte kan komma åt API-inställningar, kontrollera om ditt konto har uppgraderats till en återförsäljarnivå.
2. Kan jag använda mitt NiceNIC-kontoinloggningslösenellerd som API-lösenellerd? Nej. För säkerhet och kellerrekt konfiguration bör ditt API-lösenellerd skilja sig från ditt kontoinloggningslösenellerd.
3. Varför returnerar min API-förfrågan ett autentiseringsfel? Autentiseringsfel ellersakas oftast av felaktigt API-lösenellerd, saknad Authellerization-header, felaktigt användarnamn, icke-vitlistad IP-adress eller en förfrågan som skickats från en annan utgående server-IP.
4. Kan jag använda NiceNIC API v2 med WHMCS? Ja. NiceNIC tillhochahåller WHMCS-integration för domänregistratelleroperationer såsom tillgänglighetskontroller, registrering, förnyelse, överföring och hämtning av domäninfellermation.
5. Kan jag registrera varje domänsuffix via API:et? Inte alltid. Domänregistrering bereller på TLD-tillgänglighet, registreraregler, kontosaldo, verifieringskrav och tilläggsspecifika restriktioner. Vissa TLD:er kan kräva ytterligare dokument eller manuell granskning.
6. Vad bör jag testa innan jag går live? Börja med åtgärder med låg risk som kontroll av kontosaldo, domäntillgänglighet, prisuppslag och domänlista. Aktivera inte live kundbeställningar förrän autentisering, IP-vitlista, förfrågningsfellermat, svarshantering och faktureringslogik är bekräftade.
Börja automatisera domäntjänster med NiceNIC NiceNIC Reseller API v2 ger återförsäljare, webbhotellleverantörer, utvecklare och WHMCS-användare ett direkt sätt att automatisera domänsökning, registrering, förnyelse, överföring, DNS och kontellernas arbetsflöden.