API-oversigt
NiceNIC Domain API v2 – Dokumentation og hurtig start
NiceNIC Domain API v2 er tilgængelig for både markedskonti og forhandlerkonti. Brug denne oversigt til at konfigurere adgang, bekræfte din første forespørgsel, forstå API-svarmodellen og gå direkte til den relevante sektion i venstrenavigationen.
API-adgang og forhandlerpriser er adskilt.
Markedskonto: API-adgang med prisstruktur for markedskonto.
Forhandlerkonto: API-adgang med de priser, der er tildelt den aktuelle forhandlerniveau.
Sammenlign forhandlerniveauer og priser →
Markedskonto: API-adgang med prisstruktur for markedskonto.
Forhandlerkonto: API-adgang med de priser, der er tildelt den aktuelle forhandlerniveau.
Sammenlign forhandlerniveauer og priser →
Basis-endepunkt
https://api.nicenic.net/v2/
Påkrævede headere
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Standard svar ved succes
{ "code": 0, "msg": "success", "data": {} }
API-sandkasse
Test din integration, før du går live
Brug NiceNIC API Sandbox til at teste din Domain API-integration, før du går i produktion. Valider godkendelse, API-anmodninger, svarhåndtering og din applikations arbejdsgang i et dedikeret testmiljø.
Ideel til forhandlere, hostingudbydere, udviklere og platforme, der forbereder en API-integration.
Hurtig start
Foretag dit første API-kald i 4 trin
Start med en skrivebeskyttet anmodning, før du aktiverer live-registreringer, fornyelser eller overførsler. Dette giver dig mulighed for at validere godkendelse, anmodningsformatering og svarhåndtering uden at afgive en betalt ordre.
1
Aktivér API-adgang
Åbn API-indstillinger, opret eller hent din API-hemmelighed, og konfigurer autoriserede server-IP'er, hvor det er relevant.
2
Bekræft godkendelse
Brug HTTPS med Authorization-headeren i formatet username:api_secret.
3
Kør en sikker test
Start med domænetilgængelighed, priser, kontosaldo eller domæneliste.
4
Håndter svaret
Læs og gem de returnerede code og msg, før du aktiverer betalte produktionshandlinger.
Anbefalet første forespørgsel: Domænetilgængelighed
Tilgængeligheds-endepunktet understøtter flere domæner i én forespørgsel ved at adskille domænenavne med kommaer.
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-kort
Vælg den arbejdsgang, du har brug for
Oversigten nedenfor afspejler venstrenavigationen. Brug den til at identificere den korrekte arbejdsgang, og åbn derefter den dedikerede endepunktside for parametre, forespørgselseksempler og svareksempler.
| Sektion | Brug det til | Dokumenterede funktioner |
|---|---|---|
| Kom godt i gang | Forbind sikkert, og forstå håndtering af svar. | API-oversigt, API-sandkasse, godkendelse, svarkoder. |
| Domæneadministration | Automatiser hele domænets livscyklus. | Tilgængelighed, list domæner, domænedetaljer, registrering, fornyelse, overførsel til, navneservere, kontakter, priser. |
| Misbrug og overholdelse | Overvåg domæner, der kræver overholdelsesmæssig opmærksomhed. | List domæner med misbrugsrapporter og hent maskinlæsbar misbrugsstatus, livscyklus for spærring, klageoplysninger og anbefalet handling. |
| DNS-poster | Administrer hostede DNS-poster programmatisk. | List, opret, opdater og slet DNS-poster. |
| Underordnede navneservere | Administrer host-/limposter for navneservere under dit eget domæne. | Opret, list, opdater og slet underordnede navneservere. |
| Konto og fakturering | Forbind automatisering til kontoniveau-kontroller. | Kontosaldo og transaktionsrelaterede kontooplysninger. |
| WHMCS API | Integrer NiceNIC i en eksisterende WHMCS-faktureringsarbejdsgang. | Tilgængelighed, registrering, fornyelse, overførsel, domænedetaljer, navneservere, kontakter og yderligere registrar-modulfunktioner. |
| API-FAQ | Løs almindelige spørgsmål om adgang, sikkerhed, test og arbejdsgange. | Berettigelse, legitimationsoplysninger, håndtering af forespørgsler, understøttede operationer og integrationsvejledning. |
Anbefalet arbejdsgang
Anbefalet første integrationsrækkefølge
En pålidelig produktionsintegration bør validere adgangs- og købsbetingelser, før den begynder at sende rigtige kundeordrer.
1. Godkendelse
API Secret + autoriseret IP
API Secret + autoriseret IP
→
2. Tilgængelighed
Skrivebeskyttet forbindelsestest
Skrivebeskyttet forbindelsestest
→
3. Priser
Forespørg nuværende kontoniveauomkostning
Forespørg nuværende kontoniveauomkostning
→
4. Saldo
Bekræft midler til betalte handlinger
Bekræft midler til betalte handlinger
→
5. Svarhåndtering
Behandl kode + msg
Behandl kode + msg
→
6. Liveoperationer
Registrer / Forny / Overfør
Registrer / Forny / Overfør
Antag ikke, at en API-anmodning er fuldført, blot fordi den blev accepteret. Nogle operationer kan returnere en afventende status og kræver stadig registerbehandling, før den endelige domænestatus er bekræftet.
Produktionsadfærd
Forstå svar med succes, afventende status og fejl
code: 0 — Succesfuldt svar Aktuelle eksempler på slutpunkter bruger code 0 for succesfuldt fuldførte svar.
code: 201 — Afventende ordre Dokumentation for registrering og overførsel kan returnere code 201, når en ordre er blevet indsendt, men den endelige behandling afventer stadig.
code: 400 — Anmodningsfejl Eksempler på slutpunkter bruger code 400 for fejl i anmodningsparametre.
Adfærd ved afventende registrering
For domæneregistrering angiver den nuværende dokumentation, at et 201-svar betyder, at ordren blev indsendt succesfuldt, og at gebyret blev trukket, men den endelige aktivering afhænger stadig af registerbekræftelse. Hvis domænet ikke kan aktiveres, returneres registreringsgebyret til NiceNIC-kontosaldoen inden for 24 timer.
Adfærd ved afventende overførsel
Overførselsendepunktet dokumenterer også 201 som en afventende ordre. Din applikation bør derfor behandle en afventende overførsel som accepteret til behandling, ikke som bevis på, at overførslen allerede er fuldført.
Priser
Forespørg priser før betalte operationer
NiceNIC's prisendpoint kan hente registrerings-, fornyelses- og overførselspriser for et domæne. De dokumenterede type-værdier er register, renew, transfer og all. Den dokumenterede periode er 1 til 10 år, med mulige undtagelser for specifikke TLD'er.
Svar på registreringspriser kan også returnere et is_premium-flag. Brug prisendpointet, før du indsender en betalt anmodning, når din applikation har brug for at kende den aktuelle pris på kontoniveau.
Gratis API-adgang ændrer ikke din prisklasse. Markedskonti bruger Markedspriser; forhandlerkonti bruger de priser, der er tildelt deres nuværende forhandlerniveau.
Domæne- og DNS-operationer
Kend forskellen mellem navneservere, DNS-poster og underordnede navneservere
| Operation | Brug den, når | Dokumenteret funktion |
|---|---|---|
| Opdater navneservere | Du vil delegere et domæne til forskellige autoritative navneservere. | Domænets navneserverendpoint understøtter en primær, sekundær og yderligere navneservere, og den aktuelle side dokumenterer en grænse på op til seks. |
| DNS-poster | Du bruger NiceNIC DNS-hosting og skal administrere zoneindstillinger. | Der er separate API'er dokumenteret til at liste, oprette, opdatere og slette DNS-poster. |
| Underordnede navneservere | Du skal bruge vært-/limposter såsom ns1.example.com. |
Opret, list, opdater og slet underordnede navneservere. Oprettelsesendepunktet kræver, at navneserverens værtsnavn matcher domænet, og accepterer en IP-adresse. |
Portefølje & overholdelse
Automatiser porteføljeovervågning, ikke kun domæneordrer
Domain API v2 inkluderer også læseoperationer, der er nyttige efter registrering. List Domains-endepunktet understøtter paginering, sortering, statusfiltrering og hold-filtrering, mens Get Domain Details returnerer registreringsdatoer, udløbsdatoer, navneservere og registrantens kontaktoplysninger.
Misbrugs- & overholdelsesovervågning
NiceNIC's Abuse & Compliance API kan liste domæner med misbrugsrapporter og returnere en detaljeret maskinlæsbar oversigt for et bestemt domæne. Det detaljerede misbrugsendepunkt dokumenterer seks domæneniveau-statusudtryk: Normal, Under Review, Pending ClientHold, ClientHold, Closed og ServerHold.
Svaret kan inkludere aktuel påvirkning, anbefalet næste handling, hold-status og tidslinje, antal klager, klagedatoer, kategorier, DNS-misbrugsklassificering, evidensstatus og rapporterede URL'er, hvor det er relevant. Dette giver platforme og forhandlere mulighed for at vise overholdelsesstatus i deres egne driftssystemer i stedet for kun at stole på manuel gennemgang.
Direkte API eller WHMCS
Vælg den integrationsmodel, der passer til dit system
| Mulighed | Bedst til | Hvad den aktuelle dokumentation tilbyder |
|---|---|---|
| Domain API v2 | Tilpassede websites, SaaS-platforme, interne systemer, tilpassede fakturerings- eller provisioning-arbejdsgange. | Direkte HTTPS + JSON-integration på tværs af domæne-, DNS-, barnameserver-, konto- og compliance-operationer. |
| WHMCS-modul | Hostingvirksomheder og forhandlere, der allerede bruger WHMCS. | Tilgængelighed, registrering, fornyelse, overdragelse, domænedetaljer, navneservere, kontakter, lås/lås op, EPP-hentning, fejllogning og valgfri testtilstand. |
Den aktuelle WHMCS-dokumentation angiver WHMCS 7.0 eller nyere, PHP 7.0 eller nyere med cURL, gyldige NiceNIC API-legitimationsoplysninger samt SSL/TLS-understøttelse som krav.
Fejlfinding
Når en API-anmodning mislykkes
Start med det returnerede svar og konfigurationsstatus i stedet for gentagne gange at forsøge den samme betalte handling.
Godkendelses- eller adgangsfejl
- Bekræft NiceNIC-brugernavnet og API Secret.
- Bekræft, at Authorization-headeren er til stede og korrekt formateret.
- Bekræft, at API Secret ikke er blevet nulstillet eller roteret.
- Hvis IP-begrænsninger er aktiveret, skal du bekræfte, at anmodningen kommer fra en autoriseret udgående server-IP.
Fejl i anmodningsparameter
- Sammenlign anmodningen med slutpunktets dokumenterede parametre.
- Bekræft påkrævede værdier, formater og handlingsnavne.
- Kontroller TLD-specifikke registreringsperioder eller kontaktkrav, hvor det er relevant.
Betalt handling fuldføres ikke med det samme
- Læs den returnerede
codeogmsg. - Behandl ikke et
201-afventende svar som endelig fuldførelse. - Bekræft kontosaldo og aktuelle priser, før du forsøger en betalt handling igen.
Har brug for NiceNIC-support
- Registrer anmodningstidsstemplet og API-handlingen.
- Inkluder domænenavnet eller det involverede objekt, hvor det er relevant.
- Inkluder den returnerede kode og besked.
- Del kun ikke-følsomme parametre; del aldrig hele API Secret i en sag.
Næste trin
Begynd med en sikker testanmodning
Aktivér API-adgang, bekræft godkendelsen, kør en tilgængeligheds- eller pris-anmodning, og kontrollér din håndtering af svaret, før du aktiverer kundevendte betalte handlinger.
Sidst verificeret: 26. august 2026
