Documentatie voor klanten en partners van Digitaal Vlaanderen - bouwstenen Mijn Burgerprofiel, Verenigingsloket en e-loketondernemers
API-specificaties Melding doen
Over deze documentatie
In deze documentatie vindt u de API-specificaties waar uw applicatie moet aan voldoen om gebruikers van de gemeente app/Mijn Burgerprofiel app meldingen te laten doen. Zo kunt u met een beperkte configuratie meldingen beschikbaar maken in de gemeente app/Mijn Burgerprofiel app.
URL's en versiebeheer
De URL voor uw endpoint kan er als volgt uitzien:https://<hostname>/v1/melding/configuration
Voeg altijd een versienummer toe aan de URL, in de vorm van een cijfer, bijv. v1
, v2
, …
Er kunnen nooit breaking changes bestaan binnen een bepaalde versie. Zijn er toch breaking changes nodig, zorg dan voor een nieuwe versie.
Foutberichten
De foutberichten die teruggeven worden moeten conform de API-design richtlijnen zijn. Deze zijn gebaseerd op RFC 7807 - Problem Details for HTTP API's.
Authenticatie
Het Vlaams Toegangsbeheer (ACM) wordt gebruikt als identity provider (IdP).
De authenticatie loopt via https://authenticatie.vlaanderen.be/docs/beveiligen-van-api/oauth-rest/ waarbij Mijn Burgerprofiel de afnemer (= Client) is en de dienstenleverancier als aanbieder (= Resource) optreedt.
Mijn Burgerprofiel zal bij het aanvragen van een access token de scope dv_mbp_incidents
specificeren. Deze scope moet door de dienstenleverancier als default worden toegewezen aan de client. Dit kan eenvoudig via het beheersportaal van ACM.
Meer informatie: Algemene REST API-specificaties | Authorization
Configuratie
Mijn Burgerprofiel haalt de configuratie op bij alle lokale besturen die zijn aangesloten bij een dienstenleverancier die een meldingen-applicatie aanbiedt. De dienstenleverancier bepaalt zelf voor welke lokale besturen een configuratie wordt teruggegeven.
Een configuratie bestaat uit:
De categorieën waarvoor een melding kan gedaan worden
Een JSON-schema
Specificaties waaraan de bijlage (attachment bij de melding) moet voldoen
Categorieën
Een melding kan worden gedaan voor meerdere categorieën. Een categorie bestaat uit:
id
: unique identifier, vaak een UUIDname
: betekenisvolle omschrijving van de categorie, bijv. wateroverlast, gebrek aan de weg, parkeerplaats, ….parentId
(optioneel): via deparentId
worden hiërarchische niveau’s meegegeven aan de categorieën
Mijn Burgerprofiel ondersteunt maximaal 3 niveau’s en verwacht minimaal 1 categorie.
JSON-schema
Het JSON-schema definieert de verplichte velden. Bekijk een voorbeeld van een JSON-schema.
Mijn Burgerprofiel bepaalt aan de hand van het JSON-schema welke van onderstaande velden verplicht zijn:
description: omschrijving van de melding
location: adres of coördinaten
contactType: geeft aan op welke manier de melder zijn contact gegevens kan achterlaten (anoniem, authenticated, userInput)
contactattributen: firstname, lastname, rrn
adresattributen: street, number, box, zipcode, city
e-mail
phone
Bijlage
Het is mogelijk om de specificaties waaraan de bijlage (attachment bij de melding) moet voldoen te specificeren in de configuratie:
fileType: ondersteunde mediatypes in rfc6838-formaat
maxFileSize: maximale bestandsgrootte van één bijlage in KB
maxNumberOfFiles: het maximaal aantal bijlagen
Proces
Swagger-documentatie “Incidents” (Meldingen)
Voorbeeld JSON schema
Voorbeeld Response Configuraties
Voorbeeld Request Meldingen
Dit is een officiële website van de Vlaamse overheid - Uitgegeven door Digitaal Vlaanderen: https://www.vlaanderen.be/digitaal-vlaanderen
DISCLAIMER: http://www.vlaanderen.be/nl/disclaimer
TOEGANKELIJKHEID:
http://www.vlaanderen.be/nl/toegankelijkheid