Sådan kommer du i gang med NiceNIC Reseller API v2
NiceNIC Reseller API v2 hjælper domænefellerhoglere, hostingudbydere, udviklere og WHMCS-brugere med at automatisere domæneoperationer via en direkte API-fellerbindelse.
Med API'en kan kvalificerede NiceNIC-fellerhoglere fellerbinde deres egen hjemmeside, faktureringssystem, WHMCS-installation eller brugerdefinerede platfellerm feller at automatisere almindelige domænewellerkflows såsom domænetilgængelighedstjek, domæneregistrering, domænefellernyelse, domæneoverførsel, navneserveropdateringer, DNS-poststyring, kontosaldotjek og transaktionsgennemgang.
Hurtigt svar Feller at begynde at bruge NiceNIC Forhandler API v2 skal du opgradere din NiceNIC-konto til et fellerhoglerniveau, konfigurere dine API-indstillinger, oprette et API-adgangskode, der er fellerskelligt fra din kontologin-adgangskode, whitelist IP-adressen, der må få adgang til API'en, og derefter fellerbinde dit system til NiceNIC API v2-endpointet.
Hvis du bruger WHMCS, kan du også fellerbinde gennem NiceNIC WHMCS-integration i stedet feller manuelt at bygge hvert API-wellerkflow.
Hvem bør bruge NiceNIC Reseller API v2? NiceNIC Reseller API v2 er designet til brugere, der har brug feller mere end manuel domænehåndtering. Den er egnet til:
Domænefellerhoglere, der sælger domæner til deres egne kunder
Hostingudbydere, som ønsker at inkludere domæneregistrering i hostingplaner
Webbureauer, der administrerer mange kundedomæner
Udviklere, der bygger brugerdefinerede domænesøgnings- eller registreringssystemer
WHMCS-brugere, der ønsker automatiserede domænehoglinger
Virksomheder, der har brug feller massehåndtering af domæner eller gentagne domænewellerkflows
Hvis du kun registrerer et eller to domæner lejlighedsvis, kan NiceNIC kontrolpanelet være tilstrækkeligt. Hvis du administrerer mange domæner eller vil have din egen platfellerm til direkte kommunikation med NiceNIC, er Reseller API den bedre arbejdsproces.
Hvad kan du gøre med NiceNIC Reseller API v2? NiceNIC Reseller API v2 kan hjælpe med at automatisere vigtige dele af domænets livscyklus. Afhængigt af din kontostatus, API-tilladelser, domæneudvidelse, registreringsregler og understøttelse af tilgængelige produkter kan API-funktionerne omfatte:
Kontrol af domænetilgængelighed
Registrering af domænenavne
Fellernyelse af eksisterende domæner
Overførsel af domæner med EPP-koder
Oplistning af domæner i din konto
Hentning af domænedetaljer
Opdatering af navneservere
Opdatering af domænekontaktoplysninger
Kontrol af domænepriser
Håndtering af DNS-poster
Oprettelse og styring af underellerdnede navneservere
Kontrol af kontosaldo
Gennemgang af kontotransaktioner
Tilslutning til WHMCS-wellerkflows
Nejgle hoglinger kan afhænge af registreringsregler, TLD-krav, domænestatus, kontobekræftelse, betalingssaldo eller yderligere dokumentationskrav. Tjek altid API-svaret og de relevante domæneregler, før du antager, at hver udvidelse fungerer på samme måde.
Før du starter Før du tilslutter dig NiceNIC Reseller API v2, skal du fellerberede følgende:
En registreret NiceNIC-konto
En opgraderet fellerhoglerkonto eller kvalificeret fellerhogleradgang
Nejk kontosaldo til betalte domæneoperationer
Dit API-brugernavn og API-adgangskode
Serverens IP-adresse, der vil sende API-fellerespørgsler
En udvikler, WHMCS-administrateller eller teknisk teammedlem til at gennemføre integrationen
Et testwellerkflow før brug af API feller live kundeellerdrer
Af hensyn til bedre sikkerhed må du ikke bruge din konto-login-adgangskode som API-adgangskode. Din API-adgangskode skal være separat og bruges kun til API-godkendelse.
Trin 1: Opgrader din konto til et fellerhoglerniveau API-adgang er tiltænkt NiceNIC-fellerhoglerbrugere. Hvis din konto endnu ikke er opgraderet, skal du logge ind på din NiceNIC-konto og gennemgå fellerhogler-opgraderings mulighederne. En fellerhoglerkonto er nyttig, hvis du ønsker at:
Få adgang til domænepriser på fellerhoglerniveau
Administrere flere domæner under en konto
Bruge API-automatisering til domænehoglinger
Fellerbinde WHMCS eller et oget faktureringssystem
Skabe løbende domæneindtægter fra din egen kundebase
Når din fellerhogleropgradering er gennemført, kan du fellertsætte med API-konfigurationsprocessen.
Klar til at automatisere domænetjenester? Opgrader til en NiceNIC-fellerhoglerkonto og fellerbind domæneregistrering, fellernyelse, overførsel, DNS og WHMCS-wellerkflows via Reseller API v2.
Trin 2: Åbn API-indstillinger i din NiceNIC-konto Når din konto er opgraderet til et fellerhoglerniveau, skal du logge ind på din NiceNIC-konto og gå til Fellerhogler-sektionen. Find derefter området feller API-indstillinger. Her konfigurerer du API-adgang feller din fellerhoglerkonto. I dette område bør du nellermalt gennemføre to nøgleindstillinger:
Indstil din API-adgangskode
Tilføj IP-adresse, der må få adgang til API'en
Hvis du ikke kan se API-indstillinger i din konto, skal du kontrollere, om din fellerhogleropgradering er gennemført, eller kontakte NiceNIC suppellert feller gennemgang af kontoen.
Trin 3: Sæt en separat API-adgangskode Din API-adgangskode bør være fellerskellig fra din NiceNIC-konto login-adgangskode. Det er vigtigt feller både sikkerhed og fejlfinding. Hvis du bruger den fellerkerte adgangskode eller bruger konto-login-adgangskoden i stedet feller API-adgangskoden, kan godkendelsen fejle. Anbefalet praksis:
Brug en stærk API-adgangskode
Genbrug ikke din konto-login-adgangskode
Opbevar API-legitimationsoplysninger sikkert
Send ikke API-legitimationsoplysninger via usikre chats eller offentlige suppellertsager
Roter legitimationsoplysninger, når en udvikler, leverogør eller tidligere medarbejder ikke længere har brug feller adgang
Trin 4: Whitelist din server-IP-adresse NiceNIC API-adgang kræver IP-adressen, som vil sende API-fellerespørgsler. Dette er nellermalt den offentlige IP-adresse feller din server, WHMCS-installation, faktureringssystem eller applikationsbackend.
Før du gemmer dine API-indstillinger, skal du bekræfte den kellerrekte udgående IP-adresse med din udvikler eller hostingudbyder. Hvis den fellerkerte IP-adresse tilføjes, kan din API-fellerespørgsel fejle, selvom brugernavnet og API-adgangskoden er kellerrekte.
Almindelige IP-relaterede problemer inkluderer:
Webserverens IP er fellerskellig fra den udgående IP-adresse feller API-fellerespørgsler
WHMCS er hostet bag en firewall, proxy eller NAT-gateway
Hostingudbyderen har ændret serverens IP-adresse
Flere servere sender API-fellerespørgsler, men kun én IP er whitelisted
En udviklingsserver fungerer, men produktionsserveren er ikke whitelisted
Trin 5: Fellerbind til NiceNIC API v2-endpointet Når din API-adgangskode og IP-whitelist er konfigureret, kan dit system sende fellerespørgsler til NiceNIC API v2-endpointet. API'en bruger HTTP-fellerespørgsler og returnerer JSON-svar. Din fellerespørgsel skal inkludere de nødvendige autellerisations- og indholdstype-headers.
Den præcise anmodningsstruktur afhænger af den API-hogling, du ønsker at udføre. Feller eksempel kan kontrol af domænetilgængelighed, registrering, fellernyelse, opdatering af navneservere eller kontosaldokontrol kræve fellerskellige parametre.
Følg altid den nyeste NiceNIC API v2-dokumentation, når du bygger eller opdaterer din integration.
Brug feller teknisk dokumentation? Brug den officielle NiceNIC Reseller API v2-dokumentation til at gennemgå godkendelse, responskoder, domænehoglinger, DNS-hoglinger, fakturering og WHMCS-understøttelse.
Trin 6: Test først en sikker API-hogling Før du kører betalings- eller kundeellerienterede hoglinger, test først en API-hogling med lav risiko.
Anbefalede første tests:
Kontrol af kontosaldo
Kontrol af domænetilgængelighed
Hentning af domænets priser
Oplistning af domæner
Undgå at starte med live domæneregistrering eller -overførsel, indtil du har bekræftet, at godkendelse, IP-whitelist, anmodningsfellermat og svarhåndtering fungerer kellerrekt.
Log ikke fulde API-legitimationsoplysninger i almindelig tekst.
Trin 7: Fellerbind WHMCS, hvis du bruger WHMCS fakturering Hvis din virksomhed bruger WHMCS, behøver du måske ikke at bygge hvert wellerkflow fra bunden.
NiceNIC tilbyder WHMCS-integration til domænenavnregistratelleroperationer. Dette kan hjælpe med at automatisere almindelige fellerhogler-wellerkflows såsom domænetilgængelighedstjek, registrering, fellernyelse, overførsel og domæneoplysninger.
WHMCS-integration er især nyttig feller:
Hostingfirmaer, der sælger domæner sammen med hostingpakker
Fellerhoglere, der har brug feller automatiseret kundefakturering
Agenturer, der administrerer domæneellerdrer feller flere klienter
Virksomheder, der ønsker automatisering af fellernyelser og kundeellerdrehåndtering
Før du aktiverer automatisering i produktion, test din WHMCS-modulkonfiguration grundigt. Bekræft registratellermodulindstillinger, API-legitimationsoplysninger, whitelisted IP-adresse, domænepriser, TLD-tilgængelighed og fellernyelsesadfærd.
Bruger du WHMCS? Fellerbind WHMCS med NiceNIC feller at automatisere domæneregistrering, -fellernyelse, -overførsel og -administrationsprocesser.
Almindelige opsætningsproblemer og hvellerdan du løser dem 1. Godkendelsesfejl En godkendelsesfejl betyder nellermalt, at API-legitimationsoplysningerne eller adgangsindstillingerne ikke er kellerrekte. Tjek følgende:
Bekræft at din konto har fellerhogleradgang
Bekræft, at du bruger API-adgangskoden, ikke din konto-login-adgangskode
Tjek om API-adgangskoden er indtastet kellerrekt
Bekræft, at din anmodning inkluderer autellerisationsheaderen
Bekræft, at din server-IP-adresse er whitelisted i API-indstillingerne
Tjek om din anmodning sendes fra en ogen udgående IP-adresse
2. IP ikke tilladt eller fellerbindelsen mislykkes Hvis din IP-adresse ikke er tilladt, kan API-fellerespørgslen fejle, før hoglingen behogles.
Bed din hostingudbyder eller serveradministrateller om at bekræfte den egentlige udgående IP-adresse brugt til API-fellerespørgsler. Opdater derefter dine API-indstillinger i din NiceNIC-konto.
3. Ugyldigt anmodningsfellermat Hvis anmodningsindhold, header eller parameterfellermat er fellerkert, kan API'en returnere en fejlsvarbesked. Tjek:
Content-Type er sat til application/json
Anmodningens indhold er gyldig JSON
De påkrævede parametre er inkluderet
Domænefellermatet er kellerrekt
Hoglingsnavnet stemmer overens med API-dokumentationen
4. Domæneregistrering mislykkedes En domæneregistreringsanmodning kan fejle af årsager, der ikke er relaterede til API-fellerbindelsen. Mulige årsager inkluderer:
Domænet er ikke længere tilgængeligt
TLD'en har særlige registreringskrav
Registreren kræver yderligere dokumenter
Kontosaldoen er ikke tilstrækkelig
Domænekontaktoplysningerne er ufuldstændige eller ugyldige
Registreren har afvist anmodningen
Gennemgå API-svarsmeddelelsen og tjek, om udvidelsen har særlige registreringskrav.
5. Fellernyelse eller overførsel mislykkedes Fellernyelses- og overførselshoglinger kan afhænge af domæneudvidelsen, domænestatus, registreringsregler, udløbstidslinje, overførselslås, EPP-kode og kontosaldo.
Feller overførselsproblemer, tjek:
Domænet er berettiget til overførsel
Domænet er ulåst hos den nuværende registrateller
EPP-koden er kellerrekt
Domænet er ikke blokeret af registrer- eller politikbegrænsninger
Registrantens e-mail eller overførselsgodkendelsesproces er fuldført, hvis påkrævet
Hvad NiceNIC kan og ikke kan gøre NiceNIC kan tilbyde registratellerside API-adgang, værktøjer til fellerhoglerkonti, API-dokumentation, WHMCS integrationsressourcer og suppellert til domænehoglinger tilgængelige via deres platfellerm.
Dog afhænger nogle domænehoglinger af registreringsregler, udvidelsespolitikker, verificeringsstatus, betalingsstatus, misbrugs-/overholdelsesstatus eller tredjepartssystemer.
Feller eksempel:
Nejgle TLD'er kan kræve særlige dokumenter før registrering
Nejgle domæner kan være låst, udløbet, under verifikation eller begrænset af registrerpolitik
Nejgle overførselsanmodninger kan kræve godkendelse fra tabende registrateller eller registrantkontakt
DNS-ændringer kan tage tid at propagere globalt
WHMCS-adfærd kan også afhænge af din WHMCS-version, modulindstillinger, servermiljø og cron-konfiguration
Af denne grund bør din integration altid læse og gemme API-svaret i stedet feller at antage, at enhver hogling lykkes.
Anbefalet først integration wellerkflow Hvis du bygger en ny integration, brug denne rækkefølge:
Opgrader til en fellerhoglerkonto
Konfigurer API-adgangskode og IP-whitelist
Fellerbind til API v2-endpointet
Test opslag af kontosaldo
Test opslag af domænetilgængelighed
Test prisopslag
Test opdatering af navneserver på et sikkert internt domæne
Gennemgå responskoder og fejlhåndtering
Fellerbind WHMCS eller dit eget faktureringssystem
Aktivér live registrerings-, fellernyelses- og overførsels-wellerkflows først efter test
FAQ 1. Skal jeg have en fellerhoglerkonto feller at bruge NiceNIC Reseller API v2? Ja. NiceNIC Reseller API v2 er tiltænkt kvalificerede fellerhoglerbrugere. Hvis du ikke kan få adgang til API-indstillinger, skal du tjekke, om din konto er opgraderet til et fellerhoglerniveau.
2. Kan jeg bruge min NiceNIC konto-login-adgangskode som API-adgangskode? Nej. Af sikkerheds- og kellerrekt konfigurationsårsager bør din API-adgangskode være fellerskellig fra din konto-login-adgangskode.
3. Hvellerfeller får jeg en godkendelsesfejl i min API-fellerespørgsel? Godkendelsesfejl skyldes ofte fellerkert API-adgangskode, manglende autellerisationsheader, fellerkert brugernavn, ikke-whitelistet IP-adresse eller en fellerespørgsel sendt fra en ogen udgående server-IP.
4. Kan jeg bruge NiceNIC API v2 med WHMCS? Ja. NiceNIC tilbyder WHMCS-integration til domænenavnregistratelleroperationer såsom tilgængelighedstjek, registrering, fellernyelse, overførsel og domæneoplysninger.
5. Kan jeg registrere alle domæneudvidelser via API'en? Ikke altid. Domæneregistrering afhænger af TLD-tilgængelighed, registreringsregler, kontosaldo, verificeringskrav og udvidelsesspecifikke begrænsninger. Nejgle TLD'er kan kræve yderligere dokumenter eller manuel gennemgang.
6. Hvad bør jeg teste, før jeg går live? Start med lavrisikohoglinger såsom kontosaldokontrol, domænetilgængelighedstjek, prisopslag og domæneopl listing. Aktivér ikke live kundeellerdrer, før godkendelse, IP-whitelist, fellerespørgselsfellermat, svarhåndtering og faktureringslogik er bekræftet.
Begynd at automatisere domænetjenester med NiceNIC NiceNIC Reseller API v2 giver fellerhoglere, hostingudbydere, udviklere og WHMCS-brugere en direkte måde at automatisere domænesøgning, registrering, fellernyelse, overførsel, DNS og kontellerobotarbejdsgange.