Je eerste aanvraag

Deze pagina doorloopt één aanvraag van begin tot eind, zodat de structuur duidelijk is voordat je de rest van de API verkent.

Basis-URL en versiebeheer

Alle eindpunten bevinden zich onder een geversioneerde prefix:

Omgeving	Basis-URL
Productie	https://api.topolab.nl/v1
Staging	https://api-staging.topolab.nl/v1
Lokale	http://localhost:1337/v1

De API gebruikt URI-versiebeheer; v1 is actueel.

Een openbare aanvraag

Het opsommen van datasets vereist geen sleutel en kost geen credits:

curl "https://api.topolab.nl/v1/dataset/all?limit=2&country=nl"

Het antwoord is een gepagineerde envelop:

{
  "data": [
    {
      "table": "nl-domino-poi",
      "title": "Domino's Pizza Locaties (NL)",
      "country": "nl",
      "totalRecords": 1234,
      "qualityGrade": { "grade": "A", "score": 0.93 },
      "metadata": { "theme": "Commerce", "accrualPeriodicity": "maandelijks", "modified": "2026-05-01" }
    }
  ],
  "page": 1,
  "limit": 2,
  "total": 1187
}

Veldnamen hierboven weerspiegelen het datasetmodel; de exacte envelop is gedocumenteerd per eindpunt in de Datasets API.

Een geauthenticeerde aanvraag

Haal een datasetbestand op. Stuur de sleutel in X-API-Key; dit verbruikt credits (10 voor een volledige download):

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/dataset/nl-domino-poi/files/geojson" \
  -o nl-domino-poi.geojson

Antwoorden lezen

• Succes: 2xx. Opsommingseindpunten retourneren een gepagineerde envelop; bestandseindpunten streamen het bestand.
• Authenticatie fouten: 401 (ontbrekende/ongeldige sleutel), 403 (sleutel geldig maar mist de toestemming of add-on — bijv. API_ACCESS).
• Rate limiting: 429 wanneer je de limieten overschrijdt in Rate limieten & credits.
• Niet gevonden: 404 voor een onbekende dataset table.

Volgende

• Concepten: datasets vs collecties
• Datasets API
• OGC API