Vanlige spørsmål om NiceNIC Domain API v2

NiceNIC Domain API v2 er et HTTPS- og JSON-basert API for automatisering av domeneadministrasjon gjennom NiceNIC-kontoen din.

Det støtter kjernearbeidsflyter som tilgjengelighetssjekk for domener, registrering, fornyelse, overføring, portefølgeforespørsler, navneserver- og kontaktoppdateringer, priser, DNS-oppføringer, barnenavneservere, kontoinformasjon og samsvarsrelaterte operasjoner.

Bruk API-et når du vil koble NiceNIC-domenetjenester direkte til et nettsted, en hostingplattform, et faktureringssystem, et internt verktøy eller en annen applikasjon.

Enhver aktiv NiceNIC-konto kan bruke Domain API v2. API-tilgang er tilgjengelig for både markeds- og forhandlerkontoer.

Du trenger ikke å bli forhandler bare for å få API-tilgang. Kontotype spiller likevel en rolle for priser: betalte API-operasjoner bruker prisene som er tildelt NiceNIC-kontoen som sender forespørselen.

Åpne API-innstillinger →

Ja. API-tilgangen i seg selv er gratis. Det er ingen separat avgift for å aktivere API-tilgang eller sende støttede API-forespørsler.

Betalte operasjoner som domeneregistrering, fornyelse og overføring belastes i henhold til kontoprisene dine og gjeldende domene regler.

Nei. API-tilgang og forhandlerpriser er separate.

Du kan bruke Domain API v2 med en vanlig NiceNIC-markedskonto. Oppgrader til en forhandlerkonto bare når forhandlerpriser eller andre forhandlerfordeler er nyttige for forretningsvolumet ditt.

Sammenlign forhandlerplaner →

Domain API v2 bruker den nåværende NiceNIC API-strukturen med HTTPS-forespørsler, JSON-svar, header-basert autentisering og dokumentasjon organisert rundt individuelle domene- og kontoworkflows.

Hvis du vedlikeholder en integrasjon bygget på en eldre NiceNIC API, bør du gjennomgå API v2-parametrene og håndteringen av svar før du migrerer produksjonstrafikk, i stedet for å anta at de to versjonene er utskiftbare.

Logg inn på NiceNIC-kontoen din og åpne API-innstillinger. API v2-forespørsler bruker NiceNIC-brukernavnet ditt og API Secret for autentisering.

Åpne API-innstillinger →

Ja. NiceNIC tilbyr en API-sandkasse for utviklere for å teste integrasjoner før de kobles til produksjons-API-en.

Bruk sandkassen til å validere autentisering, forespørselsformatering, svarparsing, feilhåndtering og applikasjonsarbeidsflyten din før du aktiverer live kundedomeneoperasjoner.

Åpne API-sandkasse →

API-sandkassen er ment for utvikling og integrasjonstesting. Produksjons-API-en brukes for live domeneoperasjoner og betalte forespørsler mot NiceNIC-kontoen din.

Vi anbefaler å validere autentisering, forespørselshåndtering, svarbehandling og feillogikk i sandkassen før du aktiverer kundevendte produksjonsoperasjoner.

Send API-forespørsler over HTTPS og inkluder NiceNIC-brukernavnet ditt og API-hemmeligheten i Authorization-overskriften.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

Hvis IP-begrensninger er aktivert for kontoen din, må forespørsler også komme fra en autorisert server-IP.

Les API-autentisering →

Produksjons-API-grunnendepunktet er:

https://api.nicenic.net/v2/

API-handlinger velges ved hjelp av parameterne som er dokumentert for hvert endepunkt, for eksempel category og action. Følg alltid den dedikerte endepunktdokumentasjonen for de obligatoriske og valgfrie parameterne for en spesifikk operasjon.

API v2-svar bruker JSON, og forespørselsparametere bruker UTF-8.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

Applikasjonen din bør inspisere den returnerte code og msg i stedet for å anta at hver HTTP-respons representerer en fullført domenoperasjon.

Gjennom de for øyeblikket dokumenterte API-ene kan du automatisere arbeidsflyter, inkludert sjekk av dometilgjengelighet, registrering, fornyelse og overføring, porteføljelisting og domenedetaljer, navneserver- og domenekontaktoppdateringer, domeneprising, DNS-poster, barnenavneservere, kontoinformasjon og Abuse & Compliance-overvåking.

Flere arbeidsflyter er dokumentert enkeltvis i API-navigasjonen.

Begynn med lavrisiko-leseoperasjoner som domenetilgjengelighet, priser, kontobalanse og domenelisting.

Bekreft deretter autentisering, svarparsing, feilhåndtering og behandling av ventende ordrer før du aktiverer live-registrering, -fornyelse eller -overføring.

Ja. Check Domain Availability-endepunktet støtter flere domenenavn atskilt med komma.

example.com,example.net,example.org

Ikke anta at alle API-operasjoner støtter samme flerdomenformat for inndata. Registrering, fornyelse og overføring skal følge sin egen endepunktdokumentasjon.

Bruk Get Domain Pricing-endepunktet. De dokumenterte pristypene inkluderer register, renew, transfer og all.

Registreringssvar kan også inkludere en is_premium-verdi som angir om den forespurte registreringen er premium.

Siden API-ordrer bruker priser på kontonivå, bør du hente gjeldende priser før du sender betalte kundeordrer, i stedet for å stole på mellomlagrede priser på ubestemt tid.

Nei. Selv om API-dokumentasjonen støtter perioder på opptil 1–10 år for gjeldende utvidelser, kan individuelle TLD-er ha ulike registerregler.

Registreringsperioder, fornyelsesperioder, overføringskvalifisering, kontaktkrav og verifikasjonskrav kan variere etter utvidelse. Applikasjonen din bør følge gjeldende regler for det aktuelle TLD-et.

Dette er separate operasjoner og bør ikke behandles som om de er utskiftbare.

Bruk alltid den returnerte koden og meldingen når du fastslår statusen til en API-forespørsel.

Vis API-svarskoder →

Et 201-svar betyr at operasjonen er akseptert for behandling, men den har ikke nødvendigvis nådd sin endelige tilstand.

For domeneregistrering indikerer et 201-svar at bestillingen er sendt inn og venter på endelig behandling hos registeret.

Ikke fortell en sluttkunde at domenet er aktivt før systemet ditt har bekreftet det endelige resultatet. Følg dokumentasjonen for registreringsendepunktet for de nyeste reglene for ventende bestillinger og refusjon.

En ventende overføring betyr at overføringsforespørselen er akseptert for behandling, ikke at domenet allerede har fullført overføringen til NiceNIC.

Fullføring av overføring kan avhenge av registerets og registrarbehandlingens behandlingstid, samt domeneets gjeldende overføringsstatus. Hold overføringen i ventende status til fullføring er bekreftet.

Ja. List Domains-API-et støtter porteføljehenting med paginering, sortering og filtreringsalternativer.

Bruk Get Domain Details når du trenger detaljert informasjon om et enkelt domene, for eksempel registreringsinformasjon, utløpsinformasjon, navneservere og kontaktdata for domenet.

NiceNIC Domain API v2 inkluderer Abuse & Compliance-operasjoner utviklet for plattformer og forhandlere som administrerer kundenes domeneporteføljer.

Du kan identifisere domener knyttet til misbruksrapporter og hente maskinlesbar samsvarsinformasjon for enkeltdomener. Avhengig av saken kan svaret inkludere domenestatus, nåværende påvirkning, anbefalt handling, sperreinformasjon, klageinformasjon og rapporterte URL-er.

Dette gjør det mulig å vise samsvarsstatus direkte i din egen kundeportal eller operasjonelle system.

Ja. NiceNIC tilbyr en WHMCS-registrar-integrasjon for virksomheter som allerede bruker WHMCS til fakturering og klargjøring.

Bruk direkte Domain API v2 når du bygger din egen applikasjon eller arbeidsflyt. Bruk WHMCS-integrasjonen når du vil ha domenoperasjoner integrert i et eksisterende WHMCS-miljø.

Se WHMCS-integrasjon →

Alle serverbaserte programmeringsspråk eller kjøretidsmiljøer som kan sende HTTPS-forespørsler og analysere JSON, kan integreres med Domain API v2.

Vanlige valg inkluderer PHP, Python, Node.js og Java. Hold API-legitimasjon på serversiden, og eksponer aldri API-hemmeligheten din i nettleserbasert JavaScript eller nedlastbar klientkode.

Frekvensbegrensning kan brukes for å beskytte API-stabilitet og plattformsikkerhet.

Hvis produksjonsintegrasjonen din forventes å generere vedvarende høy forespørselsvolum, kontakt NiceNIC før lansering, slik at forventet bruksmønster kan gjennomgås.

Inkluder tidsstemplet for forespørselen, API-kategori og -handling, domenenavn der det er aktuelt, ikke-sensitive forespørselsparametere, returnert responskode og melding, samt om forespørselen kom fra Sandbox eller Production.

Send inn en billett →

Bruk API-navigasjonen i dokumentasjonen. Hver operasjon har sin egen side for støttede parametere, forespørselseksempler, responseksempler og operasjonsspesifikk atferd.

FAQ-en forklarer generell API-atferd; den individuelle endepunktdokumentasjonen bør behandles som den autoritative kilden for det eksakte forespørselsformatet.

Åpne API-dokumentasjonen →