Skift fra DAWA

DAWA (Danmarks Adressers Web API) lukkede 1. oktober 2026. Vores API svarer med DAWA's stier, parametre, feltnavne, id'er og fejlbeskeder, så din kode kan blive, som den er. Du skifter værtsnavnet og tilføjer en API-nøgle. Det er det hele.

1. Opret en konto

Opret en gratis konto med din e-mailadresse. Du får din API-nøgle med det samme, og den står også i din konsol.

2. Skift værtsnavnet

Hvor din kode kalder DAWA, skal den kalde os:

https://api.dataforsyningen.dk
https://api.getaddress.dk

Stierne er de samme: /adresser, /adgangsadresser, /autocomplete, /vejnavne, /postnumre, /datavask og deres varianter.

3. Tilføj din API-nøgle

Sæt api-key på hvert kald fra din server:

https://api.getaddress.dk/adresser/3bba05d4-c8c4-4c90-8a64-a4dff11b9d1b?api-key={your-api-key}

DAWA ignorerede parametre, den ikke kendte, og det gør vi også — så en ekstra parameter ændrer ikke andet. API-nøglen læses kun fra forespørgselsstrengen, ikke fra en header.

4. I browseren: brug et domænetoken

En API-nøgle må ikke stå i en webside, og vi afviser den, hvis den kommer fra en browser. Kode i browseren bruger i stedet et domænetoken, som du opretter i konsollen til dit eget domæne. Det sendes i api-key ligesom nøglen — eller i stien, for kode der selv bygger sine forespørgsler.

5. dawa-autocomplete2: behold den, og skift baseUrl

DAWA's eget autocomplete-widget, dawa-autocomplete2, har indstillingen baseUrl (standard https://api.dataforsyningen.dk) og kalder {baseUrl}/autocomplete. Sæt baseUrl til vores værtsnavn med dit domænetoken i stien:

dawaAutocomplete.dawaAutocomplete(document.getElementById('adresse'), {
    baseUrl: 'https://api.getaddress.dk/t/{dit-domænetoken}',
    select: function (valgt) {
        console.log(valgt.tekst);
    }
});

Resten af dine indstillinger (fuzzy, params, adgangsadresserOnly, multiline, id …) virker som før. Sådan beder widget'en om DAWA's fulde svar, og hvert svar med adresser er ét opslag. Vil du have gratis forslag, så tilføj params: { kun_tekst: true } og hent den valgte adresse selv i select (sådan) — eller skift til vores widget, der gør det for dig.

Eller skift til vores widget, getaddress-dk-autocomplete. Det er dawa-autocomplete2 med getaddress.dk's standarder: domænetokenet er et argument, og et stylesheet er med. Forslagene er gratis, og hver valgt adresse er ét opslag: widget'en henter den valgte adresse på id, før den kalder select. Skift script-tagget, og behold din select-funktion — den får det samme objekt:

<link rel="stylesheet" href="https://cdn.getaddress.io/scripts/getaddress-dk-autocomplete-1.2.0.css">
<script src="https://cdn.getaddress.io/scripts/getaddress-dk-autocomplete-1.2.0.js"></script>
<script>
    getAddressDk.autocomplete(document.getElementById('adresse'), '{dit-domænetoken}', {
        select: function (valgt) {
            console.log(valgt.tekst);
        }
    });
</script>

Eller npm install getaddress-dk-autocomplete. Begge veje er fuldt understøttede.

6. Tjek dine svar

Sider: /adresser, /adgangsadresser og /vejnavne giver højst 100 poster pr. side (per_side) og de første 100, hvis du ikke beder om en side. Hent flere med side=2, side=3 osv.
Indlejrede blokke: bebyggelser er altid tom. sogn, politikreds, retskreds, opstillingskreds, afstemningsområde, jordstykke og zone kommer fra andre registre end DAR og opdateres ikke; byg ikke på dem.
Datavask: svaret har DAWA's form, men pointgivningen er vores egen, så kategori og rækkefølge kan afvige fra DAWA's. aktueladresse er altid den samme adresse, da vi kun har gældende adresser.
Formater: json og geojson. Ikke csv eller ndjson.
Andre endpoints end dem ovenfor findes ikke her. Links (href) til fx /kommuner eller /sogne giver 404.

Hele listen står på engelsk under Differences from DAWA.

Hvad koster det?

Vejnavne og postnumre er gratis.
Et autocomplete-svar med adresser er ét opslag; et svar med vejnavne er gratis.
Med kun_tekst=true (vores, ikke DAWA's) er alle autocomplete-svar gratis: hvert forslag har kun teksten og adressens id og href. Den valgte adresse hentes så med /adresser/{id} for ét opslag.
En adresse hentet på id eller fundet ved reverse er ét opslag. En søgning koster ét opslag pr. post i svaret.
Et id, der ikke findes, koster ingenting.
Datavask er ét opslag, når svaret indeholder en adresse, og gratis, når det ikke gør.