Quickstart

Vijf minuten van nul naar data. Je gaat een API-sleutel aanmaken, een geauthenticeerde aanvraag doen en een dataset ophalen.

1. Krijg een API-sleutel

Meld je gratis aan — je krijgt 1.000 credits per maand, geen kaart vereist. In het accountportaal, open API-sleutels en maak er een aan. De sleutel wordt één keer getoond en ziet eruit als:

tlb_prod_3f9a2c7e8b1d4056a1c2e3f4a5b6c7d8

Kopieer het ergens veilig. Elke machine-aanroep stuurt het in de X-API-Key header.

2. Maak je eerste aanvraag

Bekijk de datasets die beschikbaar zijn voor jou (dit eindpunt is openbaar en kost geen credits):

curl "https://api.topolab.nl/v1/dataset/all?limit=5"

3. Haal een dataset op

Download een dataset als GeoJSON. Datasetdownloads vereisen de API_ACCESS add-on en kosten 10 credits:

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

Wil je het liever inspecteren voordat je credits uitgeeft? Haal in plaats daarvan een gratis monster op:

curl "https://api.topolab.nl/v1/dataset/nl-domino-poi/sample/json"

De drie manieren om in te komen

Kies degene die het beste bij jouw stack past:

• SDK (preview) — pip install topolab of npm install @topolab/sdk voor een idiomatische client. Zie SDKs.
• OGC API (GA) — wijs QGIS, ArcGIS of een andere OGC-client aan https://api.topolab.nl/v1/ogc. Zie OGC API.
• REST (GA) — directe HTTP, zoals hierboven. Zie Datasets API.

Volgende stappen

• Authenticatie — sleutels, de X-API-Key header en Bearer-tokens voor account-eindpunten.
• Je eerste aanvraag — de aanvraag/antwoordstructuur in detail.
• Rate-limieten & credits — wat elke oproep kost.