Om de doelen van de Common Ground te bereiken hebben we een testvoorziening nodig die je kunt aanroepen om zowel client- als provider-api's te kunnen testen, met de mogelijkheid deze te integreren in eigen automatische software tests (continuous integration). Daarbij spelen de volgende punten een belangrijke rol:
- De tests moeten worden getriggerd met de aanroep van een API, niet vanuit een grafische user interface.
- Een grafische user interface is alleen nodig voor het tonen van overzichten met resultaten en eventueel voor het instellen van wat autorisaties - wie kan beschikken over welke testresultaten.
- De tests moeten zowel consumers als providers kunnen testen en valideren met realistische scenario's.
- Het zou mooi zijn als de valideren test op twee manieren kan worden ingezet:
- voor eigen gebruik tijdens softwareontwikkeling, dan geeft het feedback over wat goed gaat en wat niet
- voor het valideren van een consumer of provider, om een stempeltje “compliant met de standaard” te verkrijgen.
- Idealiter kunnen gemeenten dezelfde constructie gebruiken om een implementatie van door leverancier ingezette software te testen tegen het testplatform.
- Wat extraatjes zoals ‘badges’ waarmee je resultaat validatie voor een bepaalde build/versie kunt tonen zou mooi zijn.
- De testvoorziening moet aanroepbaar zijn als API
- Het opstarten van tests en ophalen van resultaten loopt via REST/JSON calls
- Integratie met een eigen CI/CD pipeline is mogelijk, voorbeeld voor het doen van regressietesten
Deze repository bevat alles wat nodig is voor de ontwikkeling van een nieuw API-testplatform
Lees meer over hoe je vragen kunt stellen, bugs kunt melden en bij kunt dragen (met code of documentatie) in CONTRIBUTING.md (EN).
De volgende documenten beschrijven dit project:
- Opdrachtgever: @TheoVNGPeters
- Delivery manager: @wishalg
- Product Owner: @HenriKorver
- Scrum Master: @TCIMEddy
Copyright © VNG Realisatie 2018