Introductie API Keys

Het Dataplatform van de gemeente Amsterdam gaat het gebruik van een identificatie key bij het aanroepen van haar API's vanaf 1 februari 2024 verplicht stellen. Vanaf 1 februari 2024 kun je de API's van het Dataplatform niet meer zonder een key gebruiken. Vraag tijdig een key aan via dit aanvraagformulier. Doe je dit niet, dan werkt je applicatie of website vanaf 1 februari 2024 niet meer. Dit geldt voor alle API's die op deze pagina gedocumenteerd zijn.

Door de API key kunnen we contact houden met de gebruikers van onze API's. Zo kunnen we gebruikers informeren over updates. Daarnaast krijgen we hiermee inzicht in het gebruik van de API's en in wie welke dataset via de API bevraagt. Ook voor dataeigenaren is dit waardevolle informatie.

Meer info:
Pagina API key aanvragen
Technische documentatie
Vragen? Mail naar dataplatform@amsterdam.nl

Exportformaat opgeven

De REST API kan de resultaten in andere bestandsformaten presenteren, zodat deze gegegevens direct in de bijbehorende software ingeladen kan worden. Standaard wordt de HAL-JSON notatie gebruikt uit de DSO standaard.

Met het CSV formaat kunnen de gegevens direct in Excel worden ingelezen.

Met de parameter ?_format= kan dit gewijzigd worden. De volgende formaten worden ondersteund:

Parameter Toelichting Media type
?_format=json HAL-JSON notatie (standaard) application/hal+json
?_format=geojson GeoJSON notatie application/geo+json
?_format=csv Kommagescheiden bestand text/csv
Note
In plaats van `_format` wordt ook `format` ondersteund, maar `_format` heeft de voorkeur.
Warning
Niet ieder exportformaat ondersteund alle veldtypen die een dataset kan bevatten. Bij het gebruik van een CSV bestand worden de meer-op-meer relaties niet opgenomen in de export. In een GeoJSON bestand worden ingesloten velden opgenomen als losse objecten.
Tip
Voor het koppelen van de datasets in GIS-applicaties kun je naast het GeoJSON formaat ook gebruik maken van de `WFS koppeling `.