DOMENESENTRALEN

For utviklere

Alt du kan gjøre i panelet, kan du gjøre fra kode.

API-et er ikke et vedheng, panelet vårt bruker de samme endepunktene. Domener, DNS, fornyelser og flyttinger, med skikkelig tilgangsstyring.

Nøkler du begrenser selv

Opprett nøkler avgrenset til bestemte domener, rettigheter og IP-adresser, i panelet, ikke via en supporthenvendelse. Roter og trekk tilbake når du vil.

Webhooks

Få beskjed når et domene fornyes, en flytting fullføres eller en DNS-sone endres, i stedet for å spørre.

Bygget for automatisering

Sertifikatutstedelse med DNS-01, miljøoppsett i CI og masseoperasjoner over hele porteføljen, domenene dine er en del av verktøykjeden, ikke et sidespor.

Slik ser det ut

# List domenene dine
curl https://domenesentralen.no/api/v1/domener \
  -H "Authorization: Bearer ds_..."

# Opprett en DNS-post
curl -X POST \
  https://domenesentralen.no/api/v1/domener/eksempel.no/dns \
  -H "Authorization: Bearer ds_..." \
  -H "content-type: application/json" \
  -d '{"type":"A","navn":"@","innhold":"203.0.113.7","ttl":3600}'

Endepunkter (v1)

API-endepunkter
Metode og stiGjør
GET /api/v1/sok?domene=Er domenet ledig? Åpent, uten nøkkel
GET /api/v1/priserPrisliste. Åpent
GET /api/v1/innsikt?domene=WHOIS, DNS, SSL og hosting. Åpent
GET /api/v1/domenerList domenene dine
GET /api/v1/domener/{navn}/dnsList DNS-poster
POST /api/v1/domener/{navn}/dnsOpprett DNS-post
PUT /api/v1/domener/{navn}/dns/{id}Oppdater DNS-post
DELETE /api/v1/domener/{navn}/dns/{id}Slett DNS-post

Autentisering: Authorization: Bearer ds_…, nøkler oppretter og avgrenser du selv i panelet under API. Skriveoperasjoner krever nøkkel med skrivetilgang, og alle endringer havner i endringshistorikken med rollback.

Maskinlesbart: OpenAPI 3.1, API-katalog (RFC 9727), auth.md for agenter og llms.txt. Alle offentlige sider kan hentes som markdown med Accept: text/markdown.

MCP: koble KI-assistenten din til domenene

DOMENESENTRALEN har en innebygd MCP-server, så Claude og andre KI-assistenter kan søke etter ledige domener, slå opp priser og administrere DNS-postene dine i vanlig samtale. Samme tilgangsstyring som API-et: nøkkelen bestemmer hva assistenten får gjøre, og alle endringer havner i endringshistorikken med rollback.

Søk, priser og domeneinnsikt virker uten nøkkel. Kontoverktøyene krever innlogging: assistenter som støtter OAuth sendes til en samtykkeside hos oss første gang, ellers sender du en API-nøkkel i Authorization-headeren, akkurat som mot API-et. Serverkort og agent-skills finnes for oppdagelse.

Koble til

# Endepunkt (streamable HTTP, logg inn via OAuth)
https://domenesentralen.no/api/mcp

# Åpne verktøy uten innlogging
https://domenesentralen.no/api/aapen/mcp

# Claude Code (OAuth: nettleseren åpner samtykkesiden)
claude mcp add --transport http domenesentralen \
  https://domenesentralen.no/api/mcp

# ... eller med API-nøkkel i stedet
claude mcp add --transport http domenesentralen \
  https://domenesentralen.no/api/mcp \
  --header "Authorization: Bearer ds_..."

# Claude.ai og Claude Desktop
Innstillinger -> Koblinger -> Legg til kobling,
lim inn adressen og logg inn når du blir bedt.

OAuth 2.1 for agenter og apper

Bygger du en agent eller app som skal handle på vegne av kundene våre, trenger du ingen avtale med oss først. Registrer klienten dynamisk, send brukeren til samtykkesiden vår, og bytt koden i et token. Standard OAuth 2.1 med PKCE, ingen hemmeligheter å holde på, tokens i én time med rotert refresh token.

Scopes: les (domener og DNS) og skriv (endre DNS). Brukerens rolle på kontoen setter taket, og klientbrukere er avgrenset til egne domener. Kunden kan koble appen fra i panelet når som helst. Metadata: oauth-authorization-server, oauth-protected-resource, auth.md.

Flyten

# 1. Registrer klienten (RFC 7591, offentlig klient)
POST https://domenesentralen.no/oauth/register
{"client_name":"Min agent",
 "redirect_uris":["http://localhost:8765/cb"]}

# 2. Send brukeren hit (PKCE S256 er påkrevd)
https://domenesentralen.no/oauth/authorize
  ?response_type=code&client_id=dsc_...
  &redirect_uri=http://localhost:8765/cb
  &scope=les%20skriv&state=...
  &code_challenge=...&code_challenge_method=S256

# 3. Bytt koden
POST https://domenesentralen.no/oauth/token
grant_type=authorization_code&code=...
&code_verifier=...&client_id=dsc_...
&redirect_uri=http://localhost:8765/cb

# 4. Bruk tokenet mot /api/v1 og /api/mcp
Authorization: Bearer eyJ...

Klar til å bygge? Opprett konto.