API-oversikt
NiceNIC Domain API v2 – Dokumentasjon og hurtigstart
NiceNIC Domain API v2 er tilgjengelig for både markeds- og forhandlerkontoer. Bruk denne oversikten til å konfigurere tilgang, bekrefte din første forespørsel, forstå API-responsmodellen og gå direkte til riktig seksjon i venstremenyen.
API-tilgang og forhandlerpriser er adskilte.
Markedskonto: API-tilgang med priser for markedskonto.
Forhandlerkonto: API-tilgang med priser som er tildelt gjeldende forhandlernivå.
Sammenlign forhandlernivåer og priser →
Markedskonto: API-tilgang med priser for markedskonto.
Forhandlerkonto: API-tilgang med priser som er tildelt gjeldende forhandlernivå.
Sammenlign forhandlernivåer og priser →
Grunnleggende endepunkt
https://api.nicenic.net/v2/
Påkrevde overskrifter
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Standard vellykket svar
{ "code": 0, "msg": "success", "data": {} }
API-sandkasse
Test integreringen din før du går live
Bruk NiceNIC API-sandkassen til å teste Domain API-integreringen din før du går over i produksjon. Valider autentisering, API-forespørsler, svarhåndtering og applikasjonsarbeidsflyten din i et dedikert testmiljø.
Ideell for videreselgere, hosting-leverandører, utviklere og plattformer som forbereder en API-integrering.
Hurtigstart
Foreta ditt første API-kall i 4 trinn
Start med en skrivebeskyttet forespørsel før du aktiverer live-registreringer, fornyelser eller overføringer. Dette lar deg validere autentisering, forespørselsformatering og svarhåndtering uten å legge inn en betalt bestilling.
1
Aktiver API-tilgang
Åpne API-innstillinger, opprett eller hent API-hemmeligheten din, og konfigurer autoriserte server-IP-er der det er aktuelt.
2
Bekreft autentisering
Bruk HTTPS med Authorization-headeren i formatet username:api_secret.
3
Kjør en sikker test
Start med domenetilgjengelighet, priser, kontosaldo eller domenelisting.
4
Håndter svaret
Les og lagre de returnerte code og msg før du aktiverer betalte produksjonshandlinger.
Anbefalt første forespørsel: Domene-tilgjengelighet
Tilgjengelighet-endepunktet støtter flere domener i én forespørsel ved å skille domenenavn med komma.
curl "https://api.nicenic.net/v2/?category=domain&action=check&domains=example.com,example.net" \ -H "Authorization: username:api_secret" \ -H "Content-Type: application/json"
API-kart
Velg arbeidsflyten du trenger
Oversikten nedenfor gjenspeiler venstremenyen. Bruk den til å identifisere riktig arbeidsflyt, og åpne deretter den dedikerte endepunktsiden for parametere, forespørselseksempler og responseksempler.
| Seksjon | Bruk det til | Dokumenterte funksjoner |
|---|---|---|
| Kom i gang | Koble til sikkert og forstå håndtering av svar. | API-oversikt, API-sandkasse, autentisering, responskoder. |
| Domeneadministrasjon | Automatiser den sentrale domenelivssyklusen. | Tilgjengelighet, list domener, domenedetaljer, registrering, fornyelse, overføring inn, navneservere, kontakter, priser. |
| Misbruk og samsvar | Overvåk domener som krever oppmerksomhet for samsvarshensyn. | List domener med misbruksrapporter og hent maskinlesbar misbruksstatus, livssyklus for sperring, klageinformasjon og anbefalt handling. |
| DNS-poster | Administrer DNS-poster i vertetjenesten programmatisk. | List, opprett, oppdater og slett DNS-poster. |
| Underordnede navneservere | Administrer verts- / limposter for navneservere under ditt eget domene. | Opprett, list, oppdater og slett underordnede navneservere. |
| Konto og fakturering | Koble automasjon til kontroller på kontonivå. | Kontosaldo og transaksjonsrelatert kontoinformasjon. |
| WHMCS API | Integrer NiceNIC i en eksisterende WHMCS-faktureringsarbeidsflyt. | Tilgjengelighet, registrering, fornyelse, overføring, domenedetaljer, navneservere, kontakter og ytterligere registrar-modulfunksjoner. |
| API-FAQ | Løs vanlige spørsmål om tilgang, sikkerhet, testing og arbeidsflyt. | Kvalifisering, legitimasjon, behandling av forespørsler, støttede operasjoner og integreringsveiledning. |
Anbefalt arbeidsflyt
Anbefalt første integreringssekvens
En pålitelig produksjonsintegrering bør validere tilgangs- og kjøpsbetingelser før den begynner å sende live kundeordrer.
1. Autentisering
API-hemmelighet + autorisert IP
API-hemmelighet + autorisert IP
→
2. Tilgjengelighet
Skrivebeskyttet tilkoblingstest
Skrivebeskyttet tilkoblingstest
→
3. Priser
Spør etter gjeldende kostnad på kontonivå
Spør etter gjeldende kostnad på kontonivå
→
4. Saldo
Bekreft midler for betalte handlinger
Bekreft midler for betalte handlinger
→
5. Svarhåndtering
Behandle kode + msg
Behandle kode + msg
→
6. Live operasjoner
Registrer / Forny / Overfør
Registrer / Forny / Overfør
Ikke anta at en API-forespørsel er fullført bare fordi den ble akseptert. Noen operasjoner kan returnere en ventende status og krever fortsatt registerbehandling før den endelige domenestatusen er bekreftet.
Produksjonsatferd
Forstå suksess-, ventende- og feilresponser
code: 0 — Vellykket respons Nåværende endepunkteksempler bruker code 0 for vellykkede fullførte responser.
code: 201 — Ventende ordre Registrerings- og overføringsdokumentasjon kan returnere code 201 når en ordre er sendt inn, men endelig behandling fortsatt er ventende.
code: 400 — Forespørselsfeil Endepunkteksempler bruker code 400 for feil i forespørselsparametere.
Ventende registreringsatferd
For domeneregistrering sier gjeldende dokumentasjon at en 201-respons betyr at ordren ble sendt inn vellykket og gebyret ble trukket, men endelig aktivering er fortsatt underlagt registerbekreftelse. Hvis domenet ikke kan aktiveres, returneres registreringsgebyret til NiceNIC-kontosaldoen innen 24 timer.
Ventende overføringsatferd
Overføringsendepunktet dokumenterer også 201 som en ventende ordre. Applikasjonen din bør derfor behandle en ventende overføring som akseptert for behandling, ikke som bevis på at overføringen allerede er fullført.
Priser
Forespør priser før betalte operasjoner
NiceNIC sin priskalkulator-endepunkt kan hente registrerings-, fornyelses- og overføringspriser for et domene. De dokumenterte type-verdiene er register, renew, transfer og all. Den dokumenterte perioden er 1 til 10 år, med mulige TLD-spesifikke unntak.
Svar på registreringspriser kan også returnere et is_premium-flagg. Bruk prissluttpunktet før du sender en betalt forespørsel når applikasjonen din trenger å vite gjeldende kostnad på kontonivå.
Gratis API-tilgang endrer ikke prisnivået ditt. Markedskontoer bruker priser for markedskontoer; forhandlerkontoer bruker prisen som er tildelt deres nåværende forhandlernivå.
Domene- og DNS-operasjoner
Kjenn forskjellen mellom navneservere, DNS-poster og underordnede navneservere
| Operasjon | Bruk det når | Dokumentert funksjonalitet |
|---|---|---|
| Oppdater navneservere | Du vil delegere et domene til forskjellige autoritative navneservere. | Domeneets navneserver-sluttpunkt støtter en primær, sekundær og ekstra navneservere, og den nåværende siden dokumenterer en grense på opptil seks. |
| DNS-poster | Du bruker NiceNIC DNS-hosting og må administrere soneposter. | Egne API-er er dokumentert for å liste, opprette, oppdatere og slette DNS-poster. |
| Underordnede navneservere | Du trenger host-/glue-poster, for eksempel ns1.example.com. |
Opprett, list, oppdater og slett underordnede navneservere. Opprett-endepunktet krever at navneserverens vertsnavn samsvarer med domenet, og godtar en IP-adresse. |
Portefølje og samsvar
Automatiser porteføljeovervåking, ikke bare domenebestillinger
Domene-API v2 inkluderer også leseoperasjoner som er nyttige etter registrering. Endepunktet Liste domener støtter paginering, sortering, statusfiltrering og hold-filtrering, mens Hent domenedetaljer returnerer registreringsdatoer, utløpsdatoer, navneservere og registrantens kontaktinformasjon.
Overvåking av misbruk og samsvar
Misbruks- og samsvars-API-et hos NiceNIC kan liste opp domener med misbruksrapporter og returnere et detaljert maskinlesbart sammendrag for et bestemt domene. Det detaljerte misbruksendepunktet dokumenterer 6 statusfraser på domenenivå: Normal, Under Review, Pending ClientHold, ClientHold, Closed og ServerHold.
Svaret kan inkludere nåværende påvirkning, anbefalt neste handling, hold-status og tidslinje, antall klager, klagedatoer, kategorier, DNS-misbruksklassifisering, bevisstatus og rapporterte URL-er der det er aktuelt. Dette lar plattformer og forhandlere vise samsvarsstatus i sine egne operasjonelle systemer i stedet for å kun stole på manuell gjennomgang.
Direkte API eller WHMCS
Velg integrasjonsmodellen som passer ditt system
| Alternativ | Best egnet for | Hva gjeldende dokumentasjon tilbyr |
|---|---|---|
| Domene-API v2 | Tilpassede nettsteder, SaaS-plattformer, interne systemer, tilpassede fakturerings- eller provisjoneringsarbeidsflyter. | Direkte HTTPS + JSON-integrasjon på tvers av domene-, DNS-, navneserver-, konto- og samsvarsoperasjoner. |
| WHMCS-modul | Hostingselskaper og forhandlere som allerede bruker WHMCS. | Tilgjengelighet, registrering, fornyelse, overføring, domenedetaljer, navneservere, kontakter, lås/lås opp, EPP-henting, feillogging og valgfri testmodus. |
Gjeldende WHMCS-dokumentasjon angir WHMCS 7.0 eller nyere, PHP 7.0 eller nyere med cURL, gyldige NiceNIC API-legitimasjoner og SSL/TLS-støtte som krav.
Feilsøking
Når en API-forespørsel mislykkes
Start med den returnerte responsen og konfigurasjonstilstanden, i stedet for å gjenta den samme betalte handlingen gjentatte ganger.
Autentiserings- eller tilgangsfeil
- Bekreft NiceNIC-brukernavnet og API-hemmeligheten.
- Bekreft at Authorization-headeren er til stede og riktig formatert.
- Bekreft at API-hemmeligheten ikke er tilbakestilt eller rotert.
- Hvis IP-begrensninger er aktivert, bekreft at forespørselen kommer fra den autoriserte utgående server-IP-en.
Feil i forespørselsparametere
- Sammenlign forespørselen med de dokumenterte parameterne for den aktuelle endepunktet.
- Bekreft nødvendige verdier, formater og handlingsnavn.
- Sjekk TLD-spesifikke registreringsperioder eller kontaktkrav der det er aktuelt.
Betalt operasjon fullføres ikke umiddelbart
- Les den returnerte
codeogmsg. - Ikke behandle en
201-ventende respons som endelig fullføring. - Bekreft kontosaldo og gjeldende priser før du prøver en betalt handling på nytt.
Trenger du NiceNIC-brukerstøtte
- Registrer forespørselens tidsstempel og API-handlingen.
- Inkluder domenenavnet eller objektet som er involvert, der det er aktuelt.
- Inkluder den returnerte koden og meldingen.
- Del kun ikke-sensitive parametere; publiser aldri hele API Secret i en sak.
Neste trinn
Start med en trygg testforespørsel
Aktiver API-tilgang, bekreft autentisering, kjør en tilgjengelighets- eller prisforespørsel, og kontroller at du håndterer responsene riktig før du aktiverer kundevendte betalte operasjoner.
Sist verifisert: 26. august 2026
