Home

Authenticatie

Voor alle API calls is voor de volledig versie HTTP Basic Auth vereist. Voor account gegevens kunt u contact opnemen met info@openingstijden.nl

Caching

De informatie zal zó veel mogelijk met één call kunnen worden opgevraagd zó dat de gegevens zó simpel mogelijk kunnen gecached. Door het opslaan van de gegevens in de eigen database (caching) van de partner voorkomen we een hoge load op de servers van openingstijden.nl.

Categorieën

Call om in één keer de lijst van alle categorieën op te halen.

Requests
1
Frequentie
1x per week
Caching
ja
Velden
[ id | name | url ]

Bedrijven

Call om in één keer de lijst van alle bedrijven op te halen.

Requests
1
Frequentie
1x per week
Caching
ja
Velden
[ id | category_id | url ]

Vestigingen

Call om in één keer de lijst van alle vestigingen op te halen per bedrijf

Requests
1
Frequentie
1x per week
Caching
ja
Velden
[ id | business_id | street | zipcode | city | lat | lng | url ]

Status

Call om de huidige status (open/dicht) van een vestiging te achterhalen.

Requests
1 per vestiging, of per groep vestigingen (maximaal 10).
Frequentie
bij elke request waarbij de geldigheid (expires) van de huidige status is verlopen.
Caching
ja tot einde ‘expiries’, voor elke vestiging waarvan de ‘status’ nog niet is opgehaald of waarbij de huidige tijd later is dan de tijd in ‘expiries’.
Velden
[ establishment_id | *status | **expiries ]

* status: 0 = gesloten,1 = open ,2 = pauze, 3 = 'onbekend' (alleen in het geval van feestdagen waarbij een winkelier niet expliciet heeft aangegeven open of dicht te zijn)
** expiries: de 'status' is geldig tot de tijd aangeven tijd in dit veld. Als een user op 17-06-2015 om 07:00 zoekt naar Jumbo vestigingen die om 08:00 open gaan dan hebben die vestigingen de status 0 met een geldigheid tot 17-06-2015/08:00. Zoekt de user om 08:30 vestigingen van Jumbo en die vestigingen sluiten allemaal om 22:00 dan is de status 1 met een geldigheid tot 17-06-2015/22:00.

Results

Request

Response