Spring til indhold

Grundfast

Vask mange adresser

Vask op til 50 adressestrenge i ét kald, med kategori og kandidater for hver.

POST/v1/datavask/adgangsadresser:batch

Batch-udgaven af /v1/datavask/adgangsadresser til fx en kundeliste. Hver streng vaskes præcis som i enkeltkaldet, og resultaterne kommer i samme rækkefølge som input, efter at dubletter er fjernet.

Et input uden match er ikke en fejl, men et resultat med kategori: "C" og antal: 0. Derfor er succeeded altid lig med requested, og der er ingen fejlliste. Kun en ugyldig body giver 400.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Kræver Pro-planen

På en lavere plan svarer endpointet 402. Se planerne.

Afregning

Én enhed pr. unik adressestreng.

Eksempel

curl -X POST "https://api.grundfast.dk/v1/datavask/adgangsadresser:batch" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"betegnelser":["Rådhuspladsen 1, 1550 København V","Store Torv 1, 8000 Aarhus"]}'
Svar · eksempel, forkortet200
{
  "results": [
    {
      "input": "Rådhuspladsen 1, 1550 København V",
      "kategori": "A",
      "antal": 10,
      "resultater": [
        {
          "betegnelse": "Rådhuspladsen 1, 1550 København V",
          "adgangsadresse_id": "0a3f507a-ec01-32b8-e044-0003ba298018",
          "bfe_nummer": 6033528,
          "vejnavn": "Rådhuspladsen",
          "husnr": "1",
          "postnr": "1550",
          "postnrnavn": "København V",
          "kommunekode": "0101",
          "koordinat": { "lon": 12.5695777, "lat": 55.6756275 },
          "lighed": 1
        }
      ]
    },
    {
      "input": "Store Torv 1, 8000 Aarhus",
      "kategori": "B",
      "antal": 10,
      "resultater": [
        {
          "betegnelse": "Store Torv 1, 8000 Aarhus C",
          "adgangsadresse_id": "0a3f5096-fac9-32b8-e044-0003ba298018",
          "bfe_nummer": 5621995,
          "vejnavn": "Store Torv",
          "husnr": "1",
          "postnr": "8000",
          "postnrnavn": "Aarhus C",
          "kommunekode": "0751",
          "koordinat": { "lon": 10.209303, "lat": 56.1569335 },
          "lighed": 0.923
        }
      ]
    }
  ],
  "requested": 2,
  "succeeded": 2,
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Request-body

JSON med Content-Type: application/json.

betegnelserstring[]bodypåkrævet
1–50 adressestrenge på hver 2–128 tegn efter trim.

Felter i svaret

results[].inputstring
Den trimmede inputstreng, så du kan parre resultatet med din egen række.
results[].kategori'A' | 'B' | 'C'
Samme kategori som i enkeltkaldet. Læs den sammen med results[].antal.
results[].resultaterobject[]
Op til 10 kandidater med lighed, sorteret faldende.
requestedinteger
Antal unikke strenge efter dubletfjernelse — og antal fakturerede enheder.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Body er ikke { betegnelser: string[] } med 1–50 strenge på 2–128 tegn.
401Nøglen mangler eller er ugyldig.
402Planen er under Pro.
429Burst-grænsen eller månedskvoten er nået — kvoten tjekkes mod hele batchens antal enheder.
503Adresseindekset er ikke slået til eller endnu ikke indlæst i dette miljø.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

POST /v1/datavask/adgangsadresser:batch

Bruges ofte sammen med

Læs mere om DAWA-kompatibel, og hvad data kan bruges til, på produktsiden.