Is de BAG API geschikt voor gebruik in (commerciële) toepassingen of kan ik beter op de WFS (INSPIRE) endpoints bouwen?
De BAG API is daar zeker geschikt voor, sinds eind vorig jaar (2017) is het PDOK dataplatform een A-dienst binnen het Kadaster en daarmee geen beta dienst meer.
1 like
Super! Ik zag dat het bèta tekentje weg was maar wist niet zeker wat dat precies betekent.
Hi Jasper (collega’s),
Kun je wat meer duidelijkheid geven over wat een A-dienst is en wat we daar van kunnen verwachten tav gebruik in een commerciële toepassing.
Wat we al hebben kunnen vinden:
- Details van de BAG API: https://www.pdok.nl/introductie?articleid=1948911
- Deze is onderdeel van het PDOK Data Platform. De web services daarbinnen zijn een A-dienst.
- Wat we concreet kunnen vinden over hun diensten waar ze beschikbaarheid en capaciteit voor durven afgeven staat hier: https://www.pdok.nl/sites/default/files/2._pdc_pdok_afnemers_07_okt_2015_v20.pdf
https://www.pdok.nl/sites/default/files/bibliotheek/pdc_pdok_afnemers_10_jan_2013_v11.pdf (uit 2013 dus niet zo recent)
Quotes:
PDOK garandeert een beschikbaarheid van de voorziening die ten minste overeenkomt met de Europese beschikbaarheidseisen van INSPIRE (op 1 september 2015: 99,0% beschikbaar (24 uurs), exclusief gepland onderhoud en calamiteiten).
Er is alleen nergens iets te vinden over hoeveel gepland onderhoud er is. Dus die 99% is nogal bewerkelijk, ik vermoed dat het inclusief onderhoud en calamiteiten eerder richting 98% zal gaan.
Over capaciteit:
PDOK voldoet aan de door INSPIRE gestelde capaciteitsvereisten.
In de afnemers handleiding uit 2013 stond nog: Per seconde kunnen minimaal 20 verzoeken aan een raadpleegdienst gelijktijdig kunnen worden verwerkt. Dat zijn er 1200 per minuut.
Verder nog in verschillende forum items, waaronder: https://forum.pdok.nl/t/too-many-requests-http-429/727/11 met als laatste status dat er geen rate limit policy wordt toegepast. (okt 2017).
Kun je bovenstaande nog aanvullen/verbeteren met recente informatie of met een referentie naar een samenvattende beschrijving? Dus Performance, rate limitation en beschikbaarheid zijn voor de key items om goed zicht op te kijgen.
Hallo Vincent,
Goede vragen en je hebt al een hoop zaken zelf gevonden. Voor het PDOK Dataplatform is er geen losse dienstbeschrijving beschikbaar, we zijn hier wel mee bezig maar zijn daarbij afhankelijk van een aantal andere ontwikkelingen.
Op dit moment kent de BAG API wel een API-key, maar zijn er nog geen policies van toepassing. We verwachten dit op termijn wel toe te gaan voegen waarbij de verwachting is dat tot een nog nader te bepalen aantal request per dag de API gratis beschikbaar zijn zijn en dat er daarboven abonnementen komen (ivm de kosten die wij moeten maken om het hogere aantal request mogelijk te maken). Daarmee kunnen we dan ook commercieel gebruik beter ondersteunen en dat zal dan een uitbreiding zijn op de SLA die vanuit PDOK nu geboden wordt omdat daarin de focus ligt op overheden. Wij willen met het PDOK dataplatform echter juist ook expliciet de API’s beschikbaar en geschikt maken voor commercieel gebruik.
Wat betreft de rate limit policy: die is er in oktober 2017 inderdaad af gegaan, maar inmiddels is er wel weer een rate limit policy ingesteld (ivm gebruikers die de services nogal zwaar bevroegen). Deze policy is echter zeer ruim ingesteld omdat het voor ons puur een laatste bescherming is, we willen de API’s zo inrichten en beschikbaar maken dat je bij regulier gebruik nooit tegen de rate limit aan zou lopen.
A-dienst (tegenwoordig Goud niveau genoemd) houdt het volgende in:
- openstellingstijd: 7x24 (m.u.v. onderhoud)
- service window: 5x11 (maandag-vrijdag)
- beschikbaarheidsgarantie: 98,5% (in % van service window)
- incident oplossing: 2 uur bij P1 (onbeschikbaarheid dienst)
- onderhoudsvenster: vrijdag van 18:00u-00:00u, zaterdag van 00:00u-07:00u
1 like