Fejl 401: manglende eller ugyldig API-nøgle

Status 401 betyder, at API'et ikke ved, hvem du er. Enten kom der ingen nøgle med (missing_api_key), eller også genkendes nøglen ikke (invalid_api_key). Alle kald kræver en nøgle, også de DAWA-kompatible, så det er den fejl, man oftest møder lige efter et skift fra DAWA.

Hvad du ser#

På DAWA-stierne (/adresser, /autocomplete osv.):

{
  "type": "UnauthorizedError",
  "title": "This API requires an X-Api-Key header. Get a free key in 30 seconds at https://danadresse.dk/dashboard/signup — then add 'X-Api-Key: <your key>' to every request.",
  "details": null,
  "code": "missing_api_key"
}

{
  "type": "UnauthorizedError",
  "title": "The provided API key is invalid or revoked.",
  "details": null,
  "code": "invalid_api_key"
}

På /api/v1 står den samme kode i error.code. Se Fejlformatet.

Kør diagnosescriptet først#

Scriptet tjekker de typiske fejl i selve nøglen og laver derefter ét kald:

import os
import re

import requests

raw = os.environ.get("DANADRESSE_API_KEY")
if raw is None:
    raise SystemExit("DANADRESSE_API_KEY er ikke sat i dette miljø")
key = raw.strip().strip('"').strip("'")
if key != raw:
    print("Advarsel: nøglen havde mellemrum, linjeskift eller anførselstegn omkring sig")
if not re.fullmatch(r"dawa_(live|test)_[0-9a-f]{64}", key):
    print(f"Advarsel: nøglen har ikke det forventede format (længde {len(key)})")

r = requests.get(
    "https://api.danadresse.dk/postnumre/8000",
    headers={"X-Api-Key": key},
    timeout=10,
)
try:
    code = r.json().get("code")
except ValueError:
    code = None
print(r.status_code, code or "OK")

Får du 200 OK, er nøglen i orden, og fejlen ligger i den måde, din applikation sender den på. Gå tjeklisten igennem.

missing_api_key: nøglen kom ikke frem#

Headeren har et forkert navn.

• Årsag: Nøglen er sendt som Authorization: Bearer …, Api-Key, apikey eller i JSON-body. API'et læser kun headeren X-Api-Key og query-parameteren api_key. Kun MCP-serveren på /mcp tager også Authorization: Bearer <nøgle>.
• Løsning: Brug X-Api-Key: <nøgle>. Store og små bogstaver i header-navnet er ligegyldige.

Miljøvariablen er tom i det miljø, der kører koden.

• Årsag: Nøglen er sat i din terminal, men ikke i systemd, Docker, cron, CI eller hosting-panelet. Headeren bliver sendt som X-Api-Key: uden værdi, og en tom header tæller som manglende.
• Løsning: Log længden af nøglen (aldrig selve nøglen) ved opstart, og stop programmet, hvis den er 0.

En proxy eller et framework fjerner headeren.

• Årsag: Nogle reverse proxies, API-gateways og serverless-platforme sender kun kendte headere videre.
• Løsning: Test med curl direkte mod https://api.danadresse.dk fra samme maskine. Virker det, så tillad X-Api-Key i proxyen, eller send nøglen som api_key i URL'en.

Kaldet går til http://.

• Årsag: http://api.danadresse.dk svarer med en omdirigering (301) til https://. curl uden -L viser bare en HTML-side, og nogle HTTP-klienter taber headere eller body, når de følger en omdirigering.
• Løsning: Brug altid https://.

Nøglen står kun i widget-konfigurationen et sted, der ikke bliver brugt.

• Årsag: DAWA's gamle widget læser nøglen fra script-URL'en (?key=…), fra data-api-key på script-tagget eller fra optionerne apiKey og params.api_key. Står den andre steder, sender widgetten ingen nøgle.
• Løsning: Se Fra dawa-autocomplete2.

invalid_api_key: nøglen blev ikke genkendt#

Nøglen er skrevet forkert eller afkortet.

• Årsag: Kopieret uden de sidste tegn, eller med et ekstra tegn. En nøgle er dawa_live_ eller dawa_test_ efterfulgt af 64 tegn med 0-9 og a-f.
• Løsning: Kør diagnosescriptet. Passer formatet ikke, så lav en ny nøgle under Nøgler. Nøglen vises kun én gang, så den kan ikke hentes frem igen.

Anførselstegn eller linjeskift i nøglen.

• Årsag: .env-filer med KEY="…" læst af et værktøj, der ikke fjerner anførselstegnene, eller en nøgle med linjeskift fra en fil. Mellemrum omkring en nøgle i headeren bliver fjernet. I api_key= i URL'en bliver de ikke.
• Løsning: Fjern anførselstegn og whitespace, når du læser nøglen.

Nøglen er slettet eller roteret.

• Årsag: Nogen har slettet nøglen i dashboardet, eller den er skiftet ud, og den gamle står stadig i et miljø.
• Løsning: Se under Nøgler, hvilke nøgler der er aktive (de sidste fire tegn vises), og opdater konfigurationen.

Både header og URL har en nøgle.

• Årsag: Headeren vinder. En gammel nøgle i headeren giver invalid_api_key, selv om URL'en har den nye.
• Løsning: Send kun én af dem.

Nøglen fra et andet produkt.

• Årsag: En Datafordeler-nøgle eller en nøgle fra en anden tjeneste i den samme variabel.
• Løsning: Brug en nøgle fra danadresse.dk/dashboard/keys.

401 på dashboard-API'et#

Endpoints som /api/v1/keys og /api/v1/webhooks bruger en login-token (JWT) i Authorization: Bearer …, ikke en API-nøgle. Uden token får du error.code unauthorized. Med en udløbet eller forkert token får du invalid_token. Hent en ny token med POST /api/v1/auth/login.

Næste skridt#

• Header eller api_key i URL'en
• Fejl 403: adgang nægtet, hvis nøglen bliver genkendt, men afvist.
• Testnøgler og sandbox