Digitaal Stelsel Omgevingswet Leveranciersdag Openstelsel Knooppunt / API-URI strategie Demo afmenen service 14-06-2017 Bob Coret (Product Owner –

Presentatie over: "Digitaal Stelsel Omgevingswet Leveranciersdag Openstelsel Knooppunt / API-URI strategie Demo afmenen service 14-06-2017 Bob Coret (Product Owner –"— Transcript van de presentatie:

1 Digitaal Stelsel Omgevingswet Leveranciersdag Openstelsel Knooppunt / API-URI strategie Demo afmenen service Bob Coret (Product Owner – PR10) Mark Bakkers (Business Analist –PR05) Frank Terpstra (Product Owner – PR05)

2 Agenda Openstelsel (Bob) DSO & Knooppunt (Frank)
API-URI strategie (Frank) Demo Afnemen service (Mark) Afsluiten en vragen Demo PR05 – afnemen service

3 Open stelsel voor derden
Kennisdagen Consultaties Hackathons Overleggen/raden Digitaal Stelsel Omgevingswet Ontwikkelaarsportaal Project zorgt voor platform waar leveranciers/developers voor ondersteuning terecht kunnen Zorgt voor randvoorwaarden voor vormen van community Zorgt voor cultuur binnen het DSO programma waar rekening wordt gehouden met ontwikkelaars buiten het DSO (epics) Zorgt dat faciliteiten zijn ingericht zodat derden kunnen aansluiten op de API’s Geen speciale afwijkende versies van API’s voor derden, eat-your-own-dogfood of drink you own champagne API- en URI-strategie Zelfbediening API documentatie Forum

4 Het DSO wordt ontwikkeld als open stelsel
Het DSO wordt ontwikkeld als open stelsel. De overheid is verantwoordelijk voor de wettelijk bepaalde functionaliteit, zoals afgesproken in het bestuursakkoord, en zij stelt derde partijen (voornamenlijk de markt) via het “open stelsel” in staat eigen toepassingen te ontwikkelen op basis van de gegevens en API’s van het stelsel (DSO-services). Alle functionaliteit en gegevens van het stelsel worden in princtip als service (API) aangeboden. Op basis van deze services kunnen derden waarde toevoegende diensten ontwikkellen. 28 december 2018

5 … met en voor leveranciers
Enquête uit naar ICT-leveranciers ICT Haalbaarheidstoets Digitaal Stelsel Omgevingwet Strategische gebruikersraad DSO op strategisch niveau, onder voorzitterschap van Dorine Burmanje Vanuit verschillende projecten consultaties (Informatie- en uitwisselingsmodel besluiten, API- en URI- strategie) Gebruik maken van bestaande podia zoals KING leveranciersdag, GeoBusinessNL, Platform Linked Data Nederland, OLO2 Leveranciersoverleg Derden niet de beschikking over alle services, bijv. als het gaat om privacy gevoelige gegevens. (app-bouwer versus ketenpartners – voldoen aan gebruiksvoorwaarden en aansluitvoorwaarden / aansluittoets) Openheid wordt bepaald door de eigenaar van de data

6 API’s aangeboden als … Open service anoniem (fair use, API key)
Open service met service garanties Service met toegangsbeperking Service met doelbinding Derden niet de beschikking over alle services, bijv. als het gaat om privacy gevoelige gegevens. (app-bouwer versus ketenpartners – voldoen aan gebruiksvoorwaarden en aansluitvoorwaarden / aansluittoets) Openheid wordt bepaald door de eigenaar van de data

7 API’s zoals … API SLA Context Indienen of aanvullen aanvraag / melding
Open met garanties Gebruikerstoepassingen Intrekken aanvraag Bericht aanvraag of melding Met toegangsbeperking Raadplegen omgevingsdocument Open zonder garanties Open met garanties Informatiehuis Ruimte Zoeken regels Bepalen leidende omgevingsdocument

8 Blijf op de hoogte Tot het ontwikkelaarsportaal in de lucht is via de website: Via twitter: Volg Via - projectleider Open Stelsel - community manager Open Stelsel

9 Agenda Openstelsel (Bob) DSO & Knooppunt (Frank)
API-URI strategie (Frank) Demo Afnemen service (Mark) Afsluiten en vragen Demo PR05 – afnemen service

10 Context DSO Afnemen services Aanbieden services
Toevoegen API store / API publisher / API manager Aanbieden services Demo PR05 – afnemen service

11 Context DSO Waarom Knooppunt
Alle APIs/services van het DSO op één plek te vinden en af te nemen Één beheer organisatie om aan te spreken i.p.v. beheerders alle individuele strategische partners DSO (RWS, Kadaster, Koop, RIVM, Geonovum, KING, Bij12) Eenvoudiger aansluiten door uniform aansluitproces(zelfbediening), gedeelde netwerk connectiviteit en authenticatiemiddelen. APIs/services op uniforme manier centraal vindbaar en gedocumenteerd. Centrale bewaking en monitoring van de keten/SLAs Demo PR05 – afnemen service

12 Knooppunt gebaseerd op Centraal aansluitpunt
Context DSO Knooppunt gebaseerd op Centraal aansluitpunt CA wordt al in productie gebruikt De software van CA kent al zelfbedieningsfunctionaliteit Met juiste configuratie is snel veel zelfbediening te bereiken Oplossing open source Connecties met veel GDI voorziening Zelfbediening nog niet in gebruik Daar waar meer dan configuratie nodig is: beheer en support vraagt samenwerking met opensource project Demo PR05 – afnemen service

13 Context DSO – CA filmpje
Demo PR05 – afnemen service

14 Agenda Openstelsel (Bob) DSO & Knooppunt (Frank) API Strategie (Frank)
Demo Afnemen service (Mark) Afsluiten en vragen Demo PR05 – afnemen service

15 API Strategie (vastgesteld)
Context DSO API Strategie (vastgesteld) Alles is een service(Restful API, bij voorkeur obv JSON) De aanpak voor services in het DSO Intern = extern (eat your own dogfood) Open stelsel voor derden (iedereen mag erbij) Digikoppeling blijft kanaal voor communicatie exclusief met overheid(formele koppelvlakken) Bijv. indienen van aanvragen en meldingen Bij bestaande services afweging (kosten/baten) Leverancier/pakket specifiek, dan REST API ervoor Demo PR05 – afnemen service

16 Context DSO API strategie Standaardiseerd voor DSO:
RESTful principes (inclusief HATEOAS-constraint in een afgeslankte vorm) Beveiliging (versleutelingen en authenticatie) Open services met API key Services met beperking OAuth gebaseerd Documentatie Open API Specification (voorheen swagger) In het Nederlands Versionering Max 3 versies tegelijk Overgangs periode max 1 jaar Actieve waarschuwing bij oude versies Major versie in URI, minor/bugfix in aanroep Demo PR05 – afnemen service

17 Context DSO API strategie Standaardiseerd voor DSO: Gebruik van JSON
JSON first Optioneel JSON schema Ondersteuning content negotiation Filteren, sorteren en zoeken Uniforme wijze van filteren en sorteren Optioneel ondersteuning vrije tekst zoeken op basis elastic search GEO-ondersteuning Ondersteuning GeoJSON CRS negotiation (WGS84,ETRS89,RD) Demo PR05 – afnemen service

18 Context DSO API strategie Standaardiseerd voor DSO: Paginering
Hypertext Application Language(HAL) hypermedia controls Caching Waar relevant worden standaard HTTP caching mechanismes toegepast Beperken van het aantal verzoeken per tijdsperiode Rate limiting wordt toegepast. Overgebleven quota opvraagbaar Foutafhandeling (status codes) Gebruik standaard HTTP status codes uit 4xx en 5xx reeks Demo PR05 – afnemen service

19 Agenda Openstelsel (Bob) DSO & Knooppunt (Frank) API Strategie (Frank)
Demo Afnemen service (Mark) Afsluiten en vragen Demo PR05 – afnemen service

20 Afnemen service - Use Case
Hand-out maken 20 stuks printen. Demo PR05 – afnemen service

21 Afnemen service - Demo Connectie maken met API store in de Ontwikkelomgeving. Deze draait op het Standaard Platform / Centraal aansluitpunt. Tonen van de basis functionaliteiten van de API store: aanmelden API store zoeken service afnemen service verkrijgen access code API overview / documentation / console / throttling info / forum afmelden service Op de flipover Demo PR05 – afnemen service

22 Agenda Openstelsel (Bob) DSO & Knooppunt (Frank) API Strategie (Frank)
Demo Afnemen service (Mark) Afsluiten en vragen Demo PR05 – afnemen service

23 Vragen Demo PR05 – afnemen service 31/03/2017

24 Back-up slides

25

26

27

28

29

30

31

32

33