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

Endpoints

Tabellen

Evenementen

De volgende velden zijn beschikbaar:

Veldnaam Type Identifier Omschrijving
id Integer Unieke aanduiding voor het evenement.
geometry Geometry Polygoon definitie van het evenement.
titel String Naam van het evenement
omschrijving String Omschrijving van het evenement.
startdatum Date Startdatum van het evenement.
einddatum Date Einddatum van het evenement.
starttijd Time Starttijd van het evenement.
eindtijd Time Eindtijd van het evenement.
url Uri URL naar een webpagina voor meer informatie.

De volgende query-parameters zijn te gebruiken:

Parameter Autorisatie Mogelijke waarden Werking
einddatum yyyy-mm-dd Test op exacte waarde (==)
einddatum[lte] Test op kleiner dan of gelijk (<=).
einddatum[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
einddatum[gte] Test op groter dan of gelijk (>=).
einddatum[gt] Test op groter dan (>).
einddatum[lt] Test op kleiner dan (<).
einddatum[not] Test of waarde niet overeenkomt (!=).
einddatum[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
eindtijd hh:mm[:ss[.ms]] Test op exacte waarde (==)
eindtijd[lte] Test op kleiner dan of gelijk (<=).
eindtijd[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
eindtijd[gte] Test op groter dan of gelijk (>=).
eindtijd[gt] Test op groter dan (>).
eindtijd[lt] Test op kleiner dan (<).
eindtijd[not] Test of waarde niet overeenkomt (!=).
eindtijd[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
geometry GeoJSON of GEOMETRY(x y ...) Test op exacte waarde (==)
id Geheel getal Test op exacte waarde (==)
id[lte] Test op kleiner dan of gelijk (<=).
id[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
id[gte] Test op groter dan of gelijk (>=).
id[gt] Test op groter dan (>).
id[lt] Test op kleiner dan (<).
id[not] Test of waarde niet overeenkomt (!=).
id[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
omschrijving Tekst Test op exacte waarde (==)
omschrijving[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
omschrijving[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
omschrijving[isempty] true | false Test of de waarde leeg is (== '' / != '')
omschrijving[not] Test of waarde niet overeenkomt (!=).
omschrijving[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
startdatum yyyy-mm-dd Test op exacte waarde (==)
startdatum[lte] Test op kleiner dan of gelijk (<=).
startdatum[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
startdatum[gte] Test op groter dan of gelijk (>=).
startdatum[gt] Test op groter dan (>).
startdatum[lt] Test op kleiner dan (<).
startdatum[not] Test of waarde niet overeenkomt (!=).
startdatum[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
starttijd hh:mm[:ss[.ms]] Test op exacte waarde (==)
starttijd[lte] Test op kleiner dan of gelijk (<=).
starttijd[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
starttijd[gte] Test op groter dan of gelijk (>=).
starttijd[gt] Test op groter dan (>).
starttijd[lt] Test op kleiner dan (<).
starttijd[not] Test of waarde niet overeenkomt (!=).
starttijd[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
titel Tekst Test op exacte waarde (==)
titel[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
titel[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
titel[isempty] true | false Test of de waarde leeg is (== '' / != '')
titel[not] Test of waarde niet overeenkomt (!=).
titel[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
url https://... Test op exacte waarde (==)
url[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
url[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
url[isempty] true | false Test of de waarde leeg is (== '' / != '')
url[not] Test of waarde niet overeenkomt (!=).
url[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).