NiceNIC Domain API v2 - ofte stillede spørgsmål

NiceNIC Domæne API v2 er en HTTPS- og JSON-baseret API til automatisering af domæneadministration via din NiceNIC-konto.

Den understøtter kerne-workflows, herunder domænetilgængelighedscheck, registrering, fornyelse, overførsel, portefølgeforespørgsler, navneserver- og kontaktopdateringer, priser, DNS-poster, underordnede navneservere, kontooplysninger og overholdelsesrelaterede handlinger.

Brug API'et, når du vil forbinde NiceNIC's domænetjenester direkte til et website, en hostingplatform, et faktureringssystem, et internt værktøj eller en anden applikation.

Enhver aktiv NiceNIC-konto kan bruge Domæne API v2. API-adgang er tilgængelig for både markedskonti og forhandlerkonti.

Du behøver ikke blive forhandler blot for at få API-adgang. Kontotype betyder stadig noget for priserne: betalte API-handlinger bruger de priser, der er tildelt den NiceNIC-konto, der sender anmodningen.

Åbn API-indstillinger →

Ja. Selve API-adgangen er gratis. Der er intet særskilt gebyr for at aktivere API-adgang eller sende understøttede API-anmodninger.

Betalte handlinger såsom domæneregistrering, fornyelse og overførsel opkræves i henhold til din kontopris og de gældende domæneregler.

Nej. API-adgang og forhandlerpriser er separate.

Du kan bruge Domain API v2 med en almindelig NiceNIC-markedskonto. Opgrader til en forhandlerkonto først, når forhandlerpriser eller andre forhandlerfordele er nyttige for din forretningsvolumen.

Sammenlign forhandlerplaner →

Domain API v2 bruger den nuværende NiceNIC API-struktur med HTTPS-anmodninger, JSON-svar, header-baseret godkendelse og dokumentation organiseret omkring individuelle domæne- og kontoworkflows.

Hvis du vedligeholder en integration bygget på et ældre NiceNIC API, skal du gennemgå API v2-parametrene og svarhåndteringen, før du migrerer produktionsdata, i stedet for at antage, at de to versioner er udskiftelige.

Log ind på din NiceNIC-konto, og åbn API-indstillinger. API v2-anmodninger bruger dit NiceNIC-brugernavn og din API-hemmelighed til godkendelse.

Åbn API-indstillinger →

Ja. NiceNIC tilbyder et API-sandkassemiljø, så udviklere kan teste integrationer, før de forbindes til produktions-API'et.

Brug sandkassemiljøet til at validere godkendelse, anmodningsformatering, svarparsing, fejlhåndtering og din applikations arbejdsgang, før du aktiverer live-domæneoperationer for kunder.

Åbn API-sandkassemiljøet →

API-sandkassemiljøet er beregnet til udvikling og integrationstest. Produktions-API'et bruges til live-domæneoperationer og betalte anmodninger mod din NiceNIC-konto.

Vi anbefaler at validere godkendelse, anmodningshåndtering, svarbehandling og fejllogik i sandkassemiljøet, før du aktiverer kundevendte produktionsoperationer.

Send API-anmodninger over HTTPS, og inkluder dit NiceNIC-brugernavn og din API-hemmelighed i Authorization-headeren.

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

Hvis IP-begrænsninger er aktiveret for din konto, skal anmodninger også stamme fra en autoriseret server-IP.

Læs API-godkendelse →

Produktions-API'ets basis-endpoint er:

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

API-handlinger vælges ved hjælp af de parametre, der er dokumenteret for hvert endpoint, såsom category og action. Følg altid den dedikerede endpoint-dokumentation for de nødvendige og valgfrie parametre til en bestemt operation.

API v2-svar bruger JSON, og anmodningsparametre bruger UTF-8.

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

Din applikation bør inspicere de returnerede code og msg i stedet for at antage, at hvert HTTP-svar repræsenterer en fuldført domæneoperation.

Gennem de aktuelt dokumenterede API'er kan du automatisere arbejdsgange, herunder domænetilgængelighedskontrol, registrering, fornyelse og overførsel, porteføljeoversigt og domænedetaljer, navneserver- og domænekontaktopdateringer, domænepriser, DNS-poster, underordnede navneservere, kontooplysninger og overvågning af misbrug & overholdelse.

Yderligere arbejdsgange er dokumenteret individuelt i API-navigationen.

Start med lavrisiko-læseoperationer såsom domænetilgængelighed, domænepriser, kontosaldo og domæneliste.

Bekræft derefter godkendelse, svarfortolkning, fejlhåndtering og håndtering af ventende ordrer, før du aktiverer live-registreringer, -fornyelser eller -overførsler.

Ja. Check Domain Availability-endepunktet understøtter flere domænenavne adskilt af kommaer.

example.com,example.net,example.org

Antag ikke, at enhver API-operation understøtter det samme multi-domæne-inputformat. Registrering, fornyelse og overførsel bør følge deres individuelle endepunktsdokumentation.

Brug Get Domain Pricing-endepunktet. De dokumenterede pristyper inkluderer register, renew, transfer og all.

Registreringssvar kan også indeholde en is_premium-værdi, der angiver, om den forespurgte registrering er premium.

Da API-ordrer bruger kontoniveau-priser, skal du forespørge på aktuelle priser, før du indsender betalte kundeordrer, i stedet for at stole ubegrænset på cachelagrede priser.

Nej. Selvom API-dokumentationen understøtter perioder på 1–10 år for gældende endelser, kan de enkelte TLD'er have forskellige registerregler.

Registreringsperioder, fornyelsesperioder, overførselsberettigelse, kontaktkrav og verifikationskrav kan variere afhængigt af endelsen. Din applikation skal følge de gældende regler for den relevante TLD.

Dette er separate operationer og bør ikke betragtes som udskiftelige.

Brug altid den returnerede kode og besked, når du skal fastslå status for en API-anmodning.

Se API-svarkoder →

Et 201-svar betyder, at handlingen er accepteret til behandling, men at den ikke nødvendigvis har nået sin endelige tilstand.

For domæneregistrering angiver et 201-svar, at ordren er sendt og afventer den endelige behandling hos registreringsdatabasen.

Fortæl ikke en slutkunde, at domænet er aktivt, før dit system har bekræftet det endelige resultat. Følg dokumentationen for registreringsendepunktet for de nyeste regler for afventende ordrer og refusion.

En afventende overdragelse betyder, at overdragelsesanmodningen er accepteret til behandling, ikke at domænet allerede er færdigoverdraget til NiceNIC.

Overførselens fuldførelse kan afhænge af registreringskontorets og forhandlerens behandling samt domænets aktuelle overførselsstatus. Hold overførslen i en ventende tilstand, indtil fuldførelsen er bekræftet.

Ja. API'et List Domains understøtter hentning af porteføljer med paginering, sortering og filtreringsmuligheder.

Brug Get Domain Details, når du har brug for detaljerede oplysninger om et enkelt domæne, såsom registreringsoplysninger, udløbsoplysninger, navneservere og domænekontaktdata.

NiceNIC Domain API v2 inkluderer Abuse & Compliance-operationer designet til platforme og forhandlere, der administrerer kunders domæneporteføljer.

Du kan identificere domæner, der er forbundet med misbrugsrapporter, og hente maskinlæsbare overholdelsesoplysninger for individuelle domæner. Afhængigt af sagen kan svaret inkludere domænestatus, aktuel påvirkning, anbefalet handling, oplysninger om blokering, klageoplysninger og rapporterede URL'er.

Dette gør det muligt at vise overholdelsesstatus direkte i din egen kundeportal eller dit driftsystem.

Ja. NiceNIC tilbyder en WHMCS-registratorintegration for virksomheder, der allerede bruger WHMCS til fakturering og klargøring.

Brug den direkte Domain API v2, når du bygger din egen applikation eller arbejdsgang. Brug WHMCS-integrationen, når du vil have domæneoperationer integreret i et eksisterende WHMCS-miljø.

Se WHMCS-integration →

Ethvert server-side programmeringssprog eller runtime, der kan sende HTTPS-anmodninger og parse JSON, kan integrere med Domain API v2.

Almindelige valg inkluderer PHP, Python, Node.js og Java. Opbevar API-legitimationsoplysninger på serversiden, og udsæt aldrig din API Secret i JavaScript på browsersiden eller i downloadbar klientkode.

Der kan anvendes hastighedsbegrænsning for at beskytte API-stabilitet og platformsikkerhed.

Hvis din produktionsintegration forventes at generere vedvarende høj forespørgselsvolumen, skal du kontakte NiceNIC før lancering, så dit forventede brugsmønster kan gennemgås.

Inkluder anmodningens tidsstempel, API-kategori og handling, domænenavn hvor relevant, ikke-følsomme anmodningsparametre, returneret svarkode og besked samt om anmodningen kom fra Sandbox eller Production.

Indsend en billet →

Brug API-navigationen i dokumentationen. Hver operation har sin egen side med understøttede parametre, anmodningseksempler, svareksempler og operationsspecifik adfærd.

Ofte stillede spørgsmål forklarer generel API-adfærd; den enkelte slutpunktsdokumentation bør betragtes som den autoritative kilde for det præcise anmodningsformat.

Åbn API-dokumentation →