DanskAdresseAPIv1
DAWAbrug denneVores V1Beta
Adresser

Autocomplete på adresser, vejnavne og postnumre

Type-ahead på tværs af adresser, vejnavne og postnumre — det endpoint et adressefelt kalder ved hvert tastetryk. Fuzzy og typo-tolerant. Begræns resultattypen med type og geografien med postnr.

GET/v1/autocomplete

Godkendelse

Authorizationstringheaderpåkrævet

Din API-nøgle som Bearer-token.

Parametre

qstringquerypåkrævet

Fritekst-søgning (prefix + fuzzy).

typestringquery

Resultattype. Udeladt = adresser. vejnavn giver ét forslag pr. vejnavn, postnummer ét pr. postnummer (data har så hhv. navn/href og nr/navn/stormodtager/href).

Mulige værdier:adresseadgangsadressevejnavnpostnummer
postnrstringquery

Begræns til postnummer.

kommunekodestringquery

Begræns til kommune (4 cifre).

per_sideintegerquery

Antal forslag. Vinder over limit, hvis begge sendes.

standard: 201–100
limitintegerquery

Ældre navn for antal forslag (maks 50). Brug per_side.

standard: 201–50
motorstringquery

dawa = svaret kommer fra DAWA-motoren (samme som /dawa/autocomplete): trinvist med vejnavn-forslag først og caretpos midt i teksten. Svaret har headeren X-Source: dawa-engine (eller v1-fallback, hvis motoren ikke svarer). Gælder ikke type=postnummer.

dawastringquery

1 = præcis DAWA’s felter (udelader confidence, forslag og similarity).

Kald

curl --request GET \
  --url "https://api.danskadresseapi.dk/v1/autocomplete" \
  --url-query "q=<q>" \
  --header "Authorization: Bearer $API_NOEGLE"
Prøv det
GET https://api.danskadresseapi.dk/v1/autocomplete

Svar

application/json

Liste af forslag

dataobject

Selve objektet: adressen/adgangsadressen (med id), vejnavnet (navn, href) eller postnummeret (nr, navn, stormodtager, href).

typestring

adresse | adgangsadresse | vejnavn | postnummer

tekststring
caretposinteger

Hvor markøren skal stå efter valg af forslaget.

forslagstekststring

Teksten der vises i forslagslisten.

stormodtagerpostnrboolean

Kun adresse-forslag.

200Eksempel
[
  {
    "data": {},
    "type": "adgangsadresse",
    "tekst": "Rådhuspladsen 1, 1550 København V",
    "caretpos": 0,
    "forslagstekst": "…",
    "stormodtagerpostnr": false
  }
]
401Manglende nøgle
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key."
  }
}