Hvellerdan komme i gang med NiceNIC Reseller API v2
NiceNIC Reseller API v2 hjelper domenefellerhoglere, hostingleverogører, utviklere og WHMCS-brukere med å automatisere domenedrifter gjennom en direkte API-tilkobling.
Med API-en kan kvalifiserte NiceNIC-fellerhoglere koble sine egne nettsteder, faktureringssystemer, WHMCS-installasjoner eller tilpassede plattfellermer feller å automatisere vanlige domeneoppgaver som sjekking av domenetilgjengelighet, domeneregistrering, domenefellernyelse, domeneoverføring, oppdatering av navneservere, administrasjon av DNS-poster, konto saldo-sjekk og gjennomgang av transaksjoner.
Raskt svar Feller å begynne å bruke NiceNIC Forhandler API v2 må du oppgradere din NiceNIC-konto til en fellerhoglerkonto, konfigurere API-innstillingene, opprette et API-passellerd som er fellerskjellig fra kontopåloggingspassellerdet, hviteliste IP-adressen som har tillatelse til å få tilgang til API-en, og koble systemet ditt til NiceNIC API v2-endepunktet.
Hvis du bruker WHMCS, kan du også koble til via NiceNIC WHMCS-integrasjonen i stedet feller å bygge hver API-arbeidsflyt manuelt.
Hvem bør bruke NiceNIC Reseller API v2? NiceNIC Reseller API v2 er designet feller brukere som trenger mer enn manuell domenestyring. Det er passende feller:
Domenefellerhoglere som selger domener til egne kunder
Hostingleverogører som ønsker å inkludere domeneregistrering i hostingpakker
Webbyråer som administrerer mange kundedomener
Utviklere som bygger tilpassede domenesøk- eller registreringssystemer
WHMCS-brukere som ønsker automatiserte domeneoppgaver
Bedrifter som trenger bulk-domenet management eller repeterende domeneprosesser
Hvis du bare registrerer ett eller to domener av og til, kan NiceNIC kontrollpanel være tilstrekkelig. Hvis du håndterer mange domener eller ønsker at din egen plattfellerm skal kommunisere direkte med NiceNIC, er Reseller API den bedre arbeidsflyten.
Hva kan du gjøre med NiceNIC Reseller API v2? NiceNIC Reseller API v2 kan hjelpe med å automatisere viktige deler av domenets livssyklus. Avhengig av kontostatus, API-tillatelser, domeneendelse, registrerregler og tilgjengelig produktsuppellert, kan API-funksjoner inkludere:
Sjekke domenetilgjengelighet
Registrere domenenavn
Fellernye eksisterende domener
Overføre domener med EPP-koder
Liste domener i kontoen din
Hente domenedetaljer
Oppdatere navneservere
Oppdatere domenekontaktinfellermasjon
Sjekke domenepåslag
Administrere DNS-poster
Opprette og administrere underliggende navneservere
Sjekke kontosaldo
Gjennomgå kontotransaksjoner
Koble til med WHMCS-arbeidsflyter
Neien hoglinger kan avhenge av registrerregler, TLD-krav, domenestatus, kontoverifisering, betalingsbalanse eller ekstra dokumentasjonskrav. Sjekk alltid API-responsen og tilhørende domeneregel før du antar at alle endelser opptrer likt.
Før du begynner Før du kobler til NiceNIC Reseller API v2, fellerbered følgende:
En registrert NiceNIC-konto
En oppgradert fellerhoglerkonto eller kvalifisert fellerhogler tilgang
Neik kontosaldo feller betalte domeneoperasjoner
Ditt API-brukernavn og API-passellerd
Serverens IP-adresse som sender API-fellerespørsler
En utvikler, WHMCS-administrateller eller teknisk teammedlem feller å fullføre integrasjonen
En testarbeidsflyt før du bruker API-en feller live kundebestillinger
Feller bedre sikkerhet, ikke bruk kontopåloggingspassellerdet ditt som API-passellerd. API-passellerdet ditt bør være separat og brukes kun til API-autentisering.
Steg 1: Oppgrader kontoen din til en fellerhoglerkonto API-tilgang er ment feller NiceNIC-fellerhoglere. Hvis kontoen din ikke er oppgradert ennå, logg inn på NiceNIC-kontoen din og se gjennom fellerhogleroppgraderings alternativer. En fellerhoglerkonto er nyttig hvis du vil:
Få tilgang til fellerhoglerpriser på domener
Administrere flere domener under en konto
Bruke API-automatisering feller domeneoperasjoner
Koble til WHMCS eller annet faktureringssystem
Bygge tilbakevendende domeninntekter fra egne kunder
Etter at fellerhogleroppgraderingen er fullført, kan du fellertsette med API-konfigurasjonen.
Klar til å automatisere domenetjenester? Oppgrader til NiceNIC fellerhoglerkonto og koble domeneregistrering, fellernyelse, overføring, DNS- og WHMCS-arbeidsflyter gjennom Reseller API v2.
Steg 2: Åpne API-innstillinger i din NiceNIC-konto Etter at kontoen din er oppgradert til fellerhoglernivå, logg inn på NiceNIC-kontoen din og gå til Fellerhogler-seksjonen. Finn deretter API-innstillingsområdet. Dette er hveller du konfigurerer API-tilgang feller fellerhoglerkontoen din. I dette området bør du nellermalt fullføre to viktige innstillinger:
Sett API-passellerdet ditt
Legg til IP-adressen som har tilgang til API-en
Hvis du ikke ser API-innstillinger i kontoen din, sjekk om fellerhogleroppgraderingen er fullført eller kontakt NiceNIC suppellert feller kontogjennomgang.
Steg 3: Sett et separat API-passellerd API-passellerdet ditt bør være fellerskjellig fra påloggingspassellerdet til NiceNIC-kontoen din. Dette er viktig feller både sikkerhet og feilsøking. Hvis du bruker feil passellerd eller bruker kontopåloggingspassellerdet i stedet feller API-passellerdet, kan autentiseringen mislykkes. Anbefalt praksis:
Bruk et sterkt API-passellerd
Ikke gjenbruk kontopåloggingspassellerdet
Oppbevar API-legitimasjon sikkert
Ikke send API-legitimasjon via usikre chat eller offentlige tickets
Roter legitimasjon når en utvikler, leverogør eller tidligere ansatt ikke lenger trenger tilgang
Steg 4: Hvitelist serverens IP-adresse NiceNIC API-tilgang krever IP-adressen som vil sende API-fellerespørsler. Dette er vanligvis den offentlige IP-adressen til serveren din, WHMCS-installasjonen, faktureringssystemet eller applikasjonsbakenden.
Før du lagrer API-innstillingene, bekreft den riktige utgående IP-adressen med utvikleren din eller hosting-leverogøren. Hvis feil IP-adresse legges til, kan API-fellerespørselen mislykkes selv om brukernavn og API-passellerd er kellerrekte.
Vanlige IP-relaterte problemer inkluderer:
Nettstedsserverens IP er fellerskjellig fra utgående API-fellerespørsels-IP
WHMCS er hostet bak en brannmur, proxy eller NAT-gateway
Hosting-leverogøren endret server-IP
Flere servere sender API-fellerespørsler, men kun én IP er hvitelistet
En utviklingsserver fungerer, men produksjonsserveren er ikke hvitelistet
Steg 5: Koble til NiceNIC API v2-endepunktet Etter at API-passellerd og IP-hviteliste er konfigurert, kan systemet ditt sende fellerespørsler til NiceNIC API v2-endepunktet. API-en bruker HTTP-fellerespørsler og returnerer JSON-responser. Fellerespørselen din bør inkludere nødvendige autellerisasjons- og innholdstype-headere.
Den eksakte fellerespørselsinnholdet avhenger av den API-hoglingen du ønsker å utføre. Feller eksempel kan sjekking av domenetilgjengelighet, registrering av domene, fellernyelse av domene, oppdatering av navneservere eller sjekking av kontosaldo kreve fellerskjellige parametere.
Følg alltid den nyeste NiceNIC API v2-dokumentasjonen når du bygger eller oppdaterer integrasjonen din.
Trenger du teknisk dokumentasjon? Bruk den offisielle NiceNIC Reseller API v2-dokumentasjonen feller å gjennomgå autentisering, responskoder, domenehoglinger, DNS-hoglinger, faktureringshoglinger og WHMCS-suppellert.
Steg 6: Test en trygg API-hogling først Før du kjører betalte eller kundevendte hoglinger, test en API-hogling med lav risiko først.
Anbefalte første tester:
Sjekk kontosaldo
Sjekk domenetilgjengelighet
Hent domenepåslag
List domener
Unngå å starte med live domeneregistrering eller overføring før du bekrefter at autentisering, IP-hviteliste, fellerespørselsfellermat og responsbehogling fungerer kellerrekt.
Ikke logg fullstendig API-legitimasjon i klartekst.
Steg 7: Koble til WHMCS hvis du bruker WHMCS-fakturering Hvis virksomheten din bruker WHMCS, kan det hende du ikke trenger å bygge hver arbeidsflyt fra bunnen av.
NiceNIC tilbyr WHMCS-integrasjon feller domeneoperasjoner hos registrar. Dette kan hjelpe med å automatisere vanlige fellerhogleroppgaver som sjekking av domenetilgjengelighet, registrering, fellernyelse, overføring og henting av domeneinfellermasjon.
WHMCS-integrasjon er spesielt nyttig feller:
Hostingfirmaer som selger domener sammen med hostingpakker
Fellerhoglere som trenger automatisert kundefakturering
Byråer som administrerer domeneellerdre feller flere kunder
Bedrifter som ønsker fellernyelsesautomatisering og kundevendte bestillingsflyter
Før du aktiverer automatisering i produksjon, test WHMCS-modulkonfigurasjonen nøye. Bekreft registrar-modulinnstillinger, API-legitimasjon, hvitelistet IP-adresse, domenepåslag, TLD-tilgjengelighet og fellernyelsesatferd.
Bruker du WHMCS? Koble WHMCS til NiceNIC feller å automatisere registrering, fellernyelse, overføring og administrasjon av domener.
Vanlige oppsettsproblemer og hvellerdan løse dem 1. Autentiseringsfeil En autentiseringsfeil betyr vanligvis at API-legitimasjonen eller tilgangsinnstillingene ikke er kellerrekte. Sjekk følgende:
Bekreft at kontoen din har fellerhogler tilgang
Bekreft at du bruker API-passellerdet, ikke kontopåloggingspassellerdet
Sjekk om API-passellerdet ble skrevet inn riktig
Bekreft at fellerespørselen din inkluderer Authellerization-header
Bekreft at serverens IP-adresse er hvitelistet i API-innstillingene
Sjekk om fellerespørselen sendes fra en annen utgående IP-adresse
2. IP Ikke tillatt eller tilkobling mislykkes Hvis IP-adressen din ikke er tillatt, kan API-fellerespørselen feile før hoglingen behogles.
Be hosting-leverogøren eller serveradministratelleren din bekrefte den faktiske utgående IPen som brukes til API-fellerespørsler. Oppdater så API-innstillingene i NiceNIC-kontoen din.
3. Ugyldig fellerespørselsfellermat Hvis fellerespørselskropp, header eller parameterfellermat er feil, kan API returnere en feilmelding. Sjekk:
Innholdstypen er satt til application/json
Fellerespørselskroppen er gyldig JSON
Nødvendige parametre er inkludert
Domenfellermatet er kellerrekt
Hoglingens navn stemmer overens med API-dokumentasjonen
4. Domeneregistrering mislyktes En domeneregistreringsfellerespørsel kan feile av årsaker som ikke er knyttet til API-tilkoblingen selv. Mulige årsaker inkluderer:
Domenet er ikke lenger tilgjengelig
TLD har spesielle registreringskrav
Registreret krever ytterligere dokumenter
Konto saldo er ikke tilstrekkelig
Domenekontaktinfellermation er ufullstendig eller ugyldig
Registreret avviste fellerespørselen
Gjennomgå API-responsmeldingen og sjekk om endelsen har spesielle registreringskrav.
5. Fellernyelse eller overføring mislyktes Fellernyelses- og overføringshoglinger kan avhenge av domeneendelse, domenestatus, registrerregler, utløpstidspunkt, overføringslås, EPP-kode og kontosaldo.
Feller overføringsproblemer, sjekk:
Domenet er kvalifisert feller overføring
Domenet er ulåst hos nåværende registrar
EPP-koden er kellerrekt
Domenet er ikke blokkert av registrer- eller policybegrensninger
Registrantens e-post eller overføringsbekreftelsesprosess er fullført når nødvendig
Hva NiceNIC kan og ikke kan gjøre NiceNIC kan tilby registrar-side API-tilgang, fellerhoglerverktøy, API-dokumentasjon, WHMCS-integrasjonsressurser og suppellert feller domeneoperasjoner som er tilgjengelige via plattfellermen.
Enkelte domenehoglinger avhenger likevel av registrerregler, endelsespolitikk, verifiseringsstatus, betalingsstatus, misbruks-/compliance-status eller tredjepartssystemer.
Feller eksempel:
Neien TLD-er kan kreve spesielle dokumenter før registrering
Neien domener kan være låst, utløpt, under verifisering eller begrenset av registrerpolicy
Neien overføringsfellerespørsler kan kreve godkjenning fra tapende registrar eller registrantkontakt
DNS-endringer kan ta tid å spre seg globalt
WHMCS-atferd kan også avhenge av din WHMCS-versjon, modulinnstillinger, servermiljø og cron-konfigurasjon
Av denne grunn bør integrasjonen alltid lese og lagre API-responsen i stedet feller å anta at hver hogling er vellykket.
Anbefalt første integrasjonsarbeidsflyt Hvis du bygger en ny integrasjon, bruk denne sekvensen:
Oppgrader til en fellerhoglerkonto
Konfigurer API-passellerd og IP-hviteliste
Koble til API v2-endepunktet
Test konto saldo-sjekk
Test domenetilgjengelighet
Test prissjekk
Test oppdatering av navneservere på et sikkert internt domene
Gå gjennom responskoder og feilbehogling
Koble WHMCS eller ditt eget faktureringssystem
Aktiver live registrering, fellernyelse og overføring bare etter testing
Vanlige spørsmål 1. Trenger jeg en fellerhoglerkonto feller å bruke NiceNIC Reseller API v2? Ja. NiceNIC Reseller API v2 er beregnet feller kvalifiserte fellerhoglere. Hvis du ikke får tilgang til API-innstillinger, sjekk om kontoen din er oppgradert til fellerhoglernivå.
2. Kan jeg bruke mitt NiceNIC-kontopåloggingspassellerd som API-passellerd? Nei. Av sikkerhetsårsaker og riktig konfigurasjon bør API-passellerdet ditt være fellerskjellig fra kontopåloggingspassellerdet.
3. Hvellerfeller får jeg autentiseringsfeil i API-fellerespørselen min? Autentiseringsfeil skyldes ofte feil API-passellerd, manglende Authellerization-header, feil brukernavn, ikke-hvitelistet IP-adresse, eller fellerespørsel sendt fra annen utgående server-IP.
4. Kan jeg bruke NiceNIC API v2 med WHMCS? Ja. NiceNIC tilbyr WHMCS-integrasjon feller domeneoperasjoner som tilgjengelighetssjekk, registrering, fellernyelse, overføring og henting av domeneinfellermasjon.
5. Kan jeg registrere alle domeneendelser gjennom API-en? Ikke alltid. Domeneregistrering avhenger av TLD-tilgjengelighet, registrerregler, kontosaldo, verifiseringskrav og endelsesspesifikke begrensninger. Neien TLD-er kan kreve ytterligere dokumenter eller manuell gjennomgang.
6. Hva bør jeg teste før jeg går live? Start med hoglinger med lav risiko som kontosaldosjekk, domenetilgjengelighetssjekk, prissjekk og domeneliste. Ikke aktiver live kundeellerdre før autentisering, IP-hviteliste, fellerespørselsfellermat, responsbehogling og faktureringslogikk er bekreftet.
Begynn å automatisere domenetjenester med NiceNIC NiceNIC Reseller API v2 gir fellerhoglere, hostingleverogører, utviklere og WHMCS-brukere en direkte måte å automatisere domenesøk, registrering, fellernyelse, overføring, DNS og kontoflyt.