Spring til indhold

Grundfast

Vask mange adresser

Vask mange adressestrenge i ét kald — 50 på Pro, flere på Scale og Enterprise — 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
Adressestrenge på hver 2–128 tegn efter trim. Antallet pr. kald følger planen: 50 på Pro, 100 på Scale og 150 på Enterprise. En længere liste afvises med 402, der nævner den plan, der tager den — eller send listen som et job.

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 strenge på 2–128 tegn, eller listen er længere, end nogen plan tager pr. kald.
401Nøglen mangler eller er ugyldig.
402Planen er under Pro, eller listen er længere end din plans loft pr. kald. Svaret nævner den plan, der tager den.
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ø.

Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.

Fejlsvar · 404
{
  "error": "property not found",
  "type": "not_found",
  "code": "not_found",
  "message": "Ressourcen findes ikke.",
  "request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
  "doc_url": "https://grundfast.dk/docs/fejl#not_found"
}

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 Adresser: lister, autocomplete og reverse, og hvad data kan bruges til, på produktsiden.