API-dokumentasjon

API-et lar deg lese domenene dine, styre DNS og navnetjenere og følge ordrer programmatisk. Med API-bestilling aktivert kan du i tillegg registrere, flytte og fornye domener mot forhåndssaldo, for egen bruk eller for å selge domener i din egen løsning. Alle priser er i norske øre (NOK). Alle svar er JSON.

Alle endepunkter har base-URL https://norgesdomene.no/api/v1 og krever autentisering. Foretrekker du å la en AI-assistent gjøre jobben, se MCP for AI-assistenter under — samme nøkkel, samme tilgang.

Eiere og administratorer på en kundekonto kan lage API-nøkler under API eller AI-assistenter (MCP) i foretaksmenyen i portalen. Nøkkelen skal bare brukes fra din egen server, aldri i nettleserkode. Send nøkkelen som et Bearer-token i Authorization-headeren. Alle nøkler starter med ndp_live_.

Authorization: Bearer ndp_live_xxxxxxxxxxxxxxxxxxxx

Nøkler har scopes. Lese-endepunkter krever domains:read eller dns:read, skriveoperasjoner krever domains:write eller dns:write. En nøkkel opprettet som «kun lesetilgang» har bare lese-scopene.

Bestilling mot forhåndssaldo (POST /domains, POST /domains/transfers og POST /domains/:id/renew) krever en nøkkel med domains:order og at kontoen har API-bestilling aktivert. Vanlige nøkler med domains:write kan ikke bruke saldoen. Uten aktivering svarer API-et 403 api_disabled, og er bestilling sperret for kontoen, 403 ordering_blocked. Alle andre endepunkter er åpne for enhver gyldig nøkkel med riktig scope.

Norgesdomene har en MCP-server (Model Context Protocol) på https://norgesdomene.no/api/mcp. Koble den til Claude Code, Cursor eller en klient med støtte for MCP over HTTP og Bearer-nøkkel, så kan assistenten sjekke domener, lese og endre DNS, bytte navnetjenere og se tjenestene på kontoen. Bestilling og betaling skjer alltid i kassen på norgesdomene.no.

Uten nøkkel finnes bare de offentlige verktøyene. Med en API-nøkkel (samme Authorization: Bearer-header som REST-API-et) kommer kontoverktøyene i tillegg, styrt av nøkkelens scopes.

Claude Code

Oppsett med innlogging i Claude Code:

claude mcp add --scope user --transport http norgesdomene-oauth https://norgesdomene.no/api/mcp/oauth
claude mcp login norgesdomene-oauth

Alternativt med API-nøkkel:

claude mcp add --scope user --transport http norgesdomene https://norgesdomene.no/api/mcp \
  --header "Authorization: Bearer ndp_live_xxxx"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "norgesdomene": {
      "url": "https://norgesdomene.no/api/mcp",
      "headers": { "Authorization": "Bearer ndp_live_xxxx" }
    }
  }
}

Du kan også koble til med innlogging på https://norgesdomene.no/api/mcp/oauth. Da velger du kundekonto og godkjenner lesetilgang uten API-nøkkel. OAuth er verifisert med Claude Code. ChatGPT, Claude Desktop og Cursor med OAuth avventer egne klienttester. Lag gjerne en egen nøkkel med kun lesetilgang for hver assistent.

Verktøy

Serveren er stateless (ingen sesjoner) og følger MCP-spesifikasjonen 2026-07-28, med støtte for eldre klienter. Med API-nøkkel deler MCP og REST-API-et samme rate limit per nøkkel. Uten nøkkel er grensen 60 forespørsler i minuttet per IP-adresse. Med innlogging er grensen 120 i minuttet per IP-adresse og per tilkobling. Begge har i tillegg et felles tak for all trafikk, så du kan få 429 før din egen grense er nådd når belastningen er høy. Over grensen svarer serveren 429 med Retry-After.

En eier eller administrator aktiverer API-bestilling under API i kundeportalen ved å godta vilkårene for API-bestilling. Du trenger ingen egen avtale. Deretter lager du en nøkkel med bestillingsrett og fyller på saldo med faktura, minst 1 000 kr. Saldoen kan brukes når betalingen er registrert.

Bestillingene prises til ordinær pris med volumrabatt og trekkes fra saldoen. Saldoen er i øre. Har du for lav saldo, svarer API-et 402 insufficient_balance uten å belaste noe. Kontoen har også en grense for antall bestillinger per døgn (standard 50). Er den nådd, svarer API-et 429 order_limit_reached. Automatisk fornyelse av domenene faktureres som før og trekkes ikke fra saldoen.

Sjekk saldo og om kontoen kan bestille med GET /account. Uten API-bestilling bruker du kassen på norgesdomene.no. MCP-verktøyet create_order_link lager lenken for deg.

Bestillinger (POST /domains, POST /domains/transfers og POST /domains/:id/renew) krever headeren Idempotency-Key med en unik streng per forsøk. Send samme nøkkel og samme innhold ved retry; du får da samme ordre uten ny belastning, med oppdatert status. Gjenbrukes nøkkelen med andre opplysninger eller en annen handling i samme nøkkelrom, svarer API-et med 409 conflict. Bruk derfor en unik nøkkel per bestilling på tvers av endepunktene.

Idempotency-Key: ordre-klient-ref-abc123

Legg til ?dryRun=true på POST /domains, POST /domains/transfers eller POST /domains/:id/renew for å teste integrasjonen uten å bestille. API-et kjører de samme kontrollene som en ekte bestilling: validering, pris, ledighet hos Norid, åpne fornyelser, døgngrensen og saldoen. Ingen ordre opprettes, ingenting trekkes fra saldoen og ingenting sendes til registeret. Idempotency-Key trengs ikke.

Går alt gjennom, svarer API-et 200 med pris og saldo etter bestillingen. Ellers får du den samme feilen som en ekte bestilling ville gitt, for eksempel 402 insufficient_balance eller 409 domain_taken. En prøvekjøring er ingen reservasjon: domenet kan bli tatt før du bestiller. For fornyelser sjekkes utløpsdatoen hos registraren først ved den ekte bestillingen.

{
  "dryRun":               true,
  "action":               "register",
  "domain":               "kundensbedrift.no",
  "subtotalOre":          14900,
  "vatOre":               3725,
  "totalOre":             18625,
  "currency":             "NOK",
  "balanceOre":           500000,
  "balanceAfterOre":      481375,
  "dailyOrdersRemaining": 47,
  "declarationRequired":  true
}

For .no-domener er registrering en tostegs-prosess. Et 202-svar fra POST /domains betyr at ordren er mottatt og saldo er reservert — ikke at domenet er registrert hos Norid ennå.