Digitaal Stelsel Omgevingswet Leveranciersdag Openstelsel Knooppunt / API-URI strategie Demo afmenen service 14-06-2017 Bob Coret (Product Owner – PR10) Mark Bakkers (Business Analist –PR05) Frank Terpstra (Product Owner – PR05)
Agenda Openstelsel (Bob) DSO & Knooppunt (Frank) API-URI strategie (Frank) Demo Afnemen service (Mark) Afsluiten en vragen Demo PR05 – afnemen service
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
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
… 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
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
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
Blijf op de hoogte Tot het ontwikkelaarsportaal in de lucht is via de website: www.aandeslagmetdeomgevingswet.nl/digitaal-stelsel Via twitter: Volg ons @openstelselDSO Via e-mail: bob.coret@kadaster.nl - projectleider Open Stelsel tessa.evers@kadaster.nl - community manager Open Stelsel
Agenda Openstelsel (Bob) DSO & Knooppunt (Frank) API-URI strategie (Frank) Demo Afnemen service (Mark) Afsluiten en vragen Demo PR05 – afnemen service
Context DSO Afnemen services Aanbieden services Toevoegen API store / API publisher / API manager Aanbieden services Demo PR05 – afnemen service
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
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
Context DSO – CA filmpje https://www.youtube.com/watch?v=dhBGGUvIE88 Demo PR05 – afnemen service
Agenda Openstelsel (Bob) DSO & Knooppunt (Frank) API Strategie (Frank) Demo Afnemen service (Mark) Afsluiten en vragen Demo PR05 – afnemen service
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
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
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
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
Agenda Openstelsel (Bob) DSO & Knooppunt (Frank) API Strategie (Frank) Demo Afnemen service (Mark) Afsluiten en vragen Demo PR05 – afnemen service
Afnemen service - Use Case Hand-out maken 20 stuks printen. Demo PR05 – afnemen service
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
Agenda Openstelsel (Bob) DSO & Knooppunt (Frank) API Strategie (Frank) Demo Afnemen service (Mark) Afsluiten en vragen Demo PR05 – afnemen service
Vragen Demo PR05 – afnemen service 31/03/2017
Back-up slides