Meer informatie over het Kennisplatform APIs is te vinden op via https://www.geonovum.nl/themas/kennisplatform-apis. Hier vind je ook de mogelijkheid je aan te melden voor de werkgroepen, het slack kanaal en de nieuwsbrief.
De API strategie bestaat uit een een inleidend document, verschillende normatieve documenten (NL GOV standaarden) en meerdere modulen die voor verschillende functionele of technische situaties kunnen worden ingezet. Een actueel overzicht van alle documenten is weergegeven in de onderstaande infographic:
De verschillende onderdelen van de NL API Strategie bevat de volgende documenten:
| Onderdeel | Documentnaam & Verwijzing naar de gepubliceerde versie |
|---|---|
| Algemeen | Inleiding NL API Strategie |
| Algemeen | Architectuur NL API Strategie |
| Algemeen | Gebruikerswensen NL API Strategie |
| Normatief | API Design Rules (ADR) |
| Normatief | Open API Specification (OAS) |
| Normatief | NL GOV OAuth profiel |
| Normatief | Digikoppeling REST API koppelvlak specificatie |
| Functionele module | GEO module |
| Technische module | Transport Security module |
| Technische module | Access control module |
De hoofdstructuur van de repository is aangepast !!!
Overzicht van de folders in de repository en het doel van de folder:
| Nr | Folder | Doel |
|---|---|---|
| 1 | archief | Parkeren en bewaren alle oude files en media die niet meer actief wordt gebruikt. |
| 2 | media | Bron voor alle style sheets en media bestanden die in de tekst worden gebruikt. Zowel de bewerkbare bronbestanden als de gerenderde .svg, .png, .jpg bestanden worden in deze folder opgeslagen. |
| 3 | overleggen | Hoofdmap voor alle werkmappen van de overleggen van de stuurgroep en werkgroepen. |
| 3.1 | /Stuurgroep | Alle bestanden, verslagen en overige stukken van de stuurgroep. |
| 3.2 | /Werkgroep API architectuur | Alle bestanden, verslagen en overige stukken van deze werkgroep. |
| 3.3 | /Werkgroep API beveiliging | Alle bestanden, verslagen en overige stukken van deze werkgroep. |
| 3.4 | /Werkgroep API design rules | Alle bestanden, verslagen en overige stukken van deze werkgroep. |
| 3.5 | /Werkgroep API design visie | Alle bestanden, verslagen en overige stukken van deze werkgroep. |
| 3.6 | /Werkgroep API strategie en beleid | Alle bestanden, verslagen en overige stukken van deze werkgroep. |
| 4 | API-strategie-algemeen | Hoofdmap van de Algemene documenten van de API Strategie. |
| 4.1 | /Inleiding | Map voor het eerste inhoudelijke en inleidende document (wat iedereen moet lezen voor een algemeen beeld van de NL API Strategie.) |
| 4.2 | /Architectuur | Map voor het architectuur document van de NL API Strategie. Dit document is een verdieping van de inleiding. [ARC] |
| 4.3 | /Gebruikerswensen | Map voor het document over gebruikerswensen en het bieden van een uitstekende developer experience. [DEX] |
| 5 | API-strategie-modules | Hoofdmap voor alle modulen |
| 5.1 | /_extensies-legacy | Map voor de verzameling van oude extenties. Deze map wordt verwijdert wanneer alle extenties zijn verwerkt tot modulen. |
| 5.2 | /_template | Map voor de template die gebruikt kan worden voor nieuwe modulen |
| 5.3 | /access-control | Map voor de module access control [ACC] |
| 5.4 | /geospatial | Map voor de module geospatial [GEO] |
| 5.5 | /transport-security | Map voor de module transport security [TRS] |
| 6 | API-strategie-governance | Hoofdmap voor alle governance documenten en bestanden van het Kennisplatform APIs en de NL-API-Strategie |