Content Comparison

...

• URL naar uw Provider API endpoint om de beschikbare formulieren op te halen. Optioneel ook een endpoint om de ingediende formulieren op te halen. Deze API moet voldoen aan de specificaties zoals omschreven in

  • (sectie “GET /api/v1/forms”)API-specificaties voor aanbieders van formulieren v1 - Draft

  • https://vlaamseoverheid.atlassian.net/l/cp/Af2dHdRS

• Uw ACM ClientId - verplicht met een inkomende trustrelatie met Mijn Burgerprofiel (zie https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/6117854932/ACM+Integratie+Informatie#Aanvragen---Provider-API). U krijgt een Token Exchange token vanuit Mijn Burgerprofiel met daarin de rrn-claim

• Om uw formulieren te kunnen embedden zorgt u ervoor dat:

  • De aangeboden formulieren voldoen aan de vormvereisten zoals omschreven in

    • API-specificaties voor aanbieders van formulieren v1 - Draft

    • https://vlaamseoverheid.atlassian.net/l/cp/Af2dHdRS

  • Een third-party-cookie API endpoint bestaat die voldoet aan deze specificaties: https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/5873176651/API-specificaties+voor+aanbieders+van+formulieren+v1+-+Draft#POST%2FGET-%2Fapi%2Fv1%2Fthird-party-cookies

  • De nodige frontend communicatie voorzien is zoals gedocumenteerd in: https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/5873176651/API-specificaties+voor+aanbieders+van+formulieren+v1+-+Draft#Frontend-communicatie-voor-ge%C3%ABmbedde-formulieren

  • Ondersteuning voor Frontend Token Exchange om de aangemelde context van Mijn Burgeprofiel naar uw systeem te kunnen doorgeven, volgens deze specificaties: Aanvraagmodule - Authenticatie via Single Sign-on (SSO)

Minimale data voor een eenvoudige aansluiting

Eenvoudige aansluiting die opent in een nieuwe tab

Hieronder staat de minimale data die nodig is voor een eenvoudige aansluiting met IPDC. Het formulier opent in een nieuwetab:

...

Door enkel de fallback mee te geven, opent het formulier in een nieuwe tab. Alleen een unieke id (deze heeft verder geen betekenis in deze set-up, gewoon een unique identifier genereren) en een productId zijn vereist. 

Eenvoudige aansluiting geëmbed in Mijn Burgerprofiel

Hieronder staat de data die nodig is om een eenvoudige aansluiting toe te voegen die onder *.vlaanderen.be valt (first-party). Door de embed-property toe te voegen kunnen deze formulieren geëmbed worden op Mijn Burgerprofiel:

{
  "_links": {
      "embed": { "href": "willekeurig-eloket.vlaanderen.be/url-naar-formulier" },
      "fallback": { "href": "willekeurig-eloket.vlaanderen.be/url-naar-formulier-met-global-header" },
   },
  "id": "ee5d582c-5c94-4f62-9f6b-424c41e129f7",
  "productId": "1456"
}

Voorbeeldcode formulier dat opent in een nieuwe tab

Voorbeeld eenvoudige aansluiting voor Fayatbeurs die opent in een nieuwe tab (zonder embed) en met aangepaste IPDC-omschrijving

...