Spring til indhold

Grundfast

Slå mange adresser op

Mange DAR-adresser i ét kald — 50 på Pro, flere på Scale og Enterprise — med resultat eller fejl for hver UUID.

POST/v1/adresse:batch

Hver UUID slås op præcis som med /v1/adresse/:uuid. Dubletter fjernes, før noget slås op — også når de kun adskiller sig i store og små bogstaver.

En UUID, der ikke kan slås op, vælter ikke kaldet: den lander i errors med sin egen status, og svaret er stadig 200. 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 UUID trækkes fra kvoten; kun de opslag, der lykkes, faktureres.

Eksempel

curl -X POST "https://api.grundfast.dk/v1/adresse:batch" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"uuid":["0a3f507a-ec01-32b8-e044-0003ba298018","74806df4-97a9-4c0c-a6cb-df07b5429e07"]}'
Svar · eksempel200
{
  "results": [
    {
      "uuid": "0a3f507a-ec01-32b8-e044-0003ba298018",
      "adresse": {
        "id": "0a3f507a-ec01-32b8-e044-0003ba298018",
        "betegnelse": "Rådhuspladsen 1, 1550 København V",
        "vejnavn": "Rådhuspladsen",
        "husnr": "1",
        "etage": null,
        "doer": null,
        "postnr": "1550",
        "postnrnavn": "København V",
        "kommunekode": null,
        "koordinat": { "lon": 12.5695777, "lat": 55.6756275 }
      },
      "stale": false
    }
  ],
  "errors": [
    {
      "uuid": "74806df4-97a9-4c0c-a6cb-df07b5429e07",
      "error": "upstream Datafordeler error",
      "status": 502
    }
  ],
  "requested": 2,
  "succeeded": 1,
  "failed": 1
}

Request-body

JSON med Content-Type: application/json.

uuidstring[]bodypåkrævet
DAR-id’er (UUID), enhedsadresser eller adgangsadresser. 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[]object[]
{ uuid, adresse, stale } for hver UUID, der blev slået op. adresse har samme form som på enkeltopslaget.
results[].staleboolean
true når adressen kom fra cachen, fordi DAR ikke svarede.
errors[]object[]
{ uuid, error, status } for hver UUID, der fejlede — fx 404 for en adresse, der ikke er gældende.
requestedinteger
Antal unikke UUID’er efter dubletfjernelse. succeeded + failed giver det samme tal.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Body er ikke { uuid: string[] } med gyldige UUID’er, 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.

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/adresse:batch

Bruges ofte sammen med

Læs mere om Adresser (DAR), og hvad data kan bruges til, på produktsiden.