Exposed API schema's
Toelichting vooraf
Onderstaande schema’s tonen de datastructuur per entiteit binnen de exposed API.
Attachment
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Verwijzingen (links) naar | Links (zie schema) |
| Naam van de bijlage | string |
| Grootte van de bijlage in MB | integer (int64) |
| Unieke GUID voor de bijlage | string |
| Bestandstype van de bijlage | string |
| Tijdsstempel ogenblik waarop de bijlage laatst is aangepast | string (date-time) |
AttachmentList
Eigenschap | Beschrijving | Formaat |
---|---|---|
|
| object |
| Verwijzingen (links) naar | Links (zie schema) |
Communication
Een communicatie is een unieke instantie van een communicatie template.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Verwijzingen (links) naar | Links (zie schema) |
| Tijdsstempel ogenblik waarop de communicatie is aangemaakt | string (date-time) |
| Unieke GUID voor de communicatie | string |
| Naam van de communicatie | string |
| Tijdsstempel ogenblik waarop de communicatie laatst is aangepast | string (date-time) |
CommunicationList
Een communicatie is een unieke instantie van een communicatie template.
Eigenschap | Beschrijving | Formaat |
---|---|---|
|
| object |
| Verwijzingen (links) naar | Links (zie schema) |
Dossier
Een dossier is een unieke instantie van een dossiertype.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Verwijzingen (links) naar | Links (zie schema) |
| Lijst van taken die actief zijn (aangemaakt, maar niet afgerond) binnen het dossier | array met Tasks (zie schema) |
| Tijdsstempel ogenblik waarop het dossier is aangemaakt | string (date-time) |
| Tekstuele dossierbeschrijving zoals ingevoerd door gebruiker bij opstart vanuit de backoffice | string |
| Verwijst naar dossiertype waarvan het dossier is afgeleid | DossierDefinition (zie schema) |
| Unieke GUID voor het dossier | string |
| Dossierlabel opgesteld volgens formattering zoals vastgelegd in de dossiertype instellingen | string |
| Verwijst naar de laatst aangemaakte mijlpaal binnen het dossier | Milestone (zie schema) |
| Tijdsstempel ogenblik waarop het dossier laatst is aangepast | string (date-time) |
DossierDefinition
Dit zijn eigenschappen van het dossiertype.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Unieke GUID voor het dossiertype | string |
| Key van het dossiertype | string |
| Naam van het dossiertype | string |
Error
Dit is de response message die je ontvangt na uitsturen van de API call. Zie het overzicht van endpoints en functies voor alle info.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| statuscode (bv. ‘200’) | sting |
| boodschap (bv. ‘Request successful. Server responded as required.’) | string |
| status (bv. ‘OK’) | string |
ExposedCreateDossierRequest
Gerelateerd aan de API call die je maakt om een dossier aan te maken. Hier moet je verplicht het dossiertype meegeven, en optioneel enkele extra parameters (te programmeren). Zie het overzicht van endpoints en functies voor alle info.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Bijkomende parameters die je kan meegeven (zie schema Link) | object |
| Key van het dossiertype. Verplicht mee te sturen als parameter in de call. | string |
Filter
Gebruik de filter in je call om specifieke dossiers naar boven te halen. Zie het overzicht van endpoints en functies voor alle info.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Filter op KBO-nummer (onderneming). Let wel: dit vereist een extra parameter met info over welk formulierveld het KBO-nummer bevat. Zie dit voorbeeld voor meer info. | string |
| Key van het dossiertype | string |
| Dossierlabel opgesteld volgens formattering zoals vastgelegd in de dossiertype instellingen | string |
| Key van het event in de workflow waarvoor een mijlpaal is geactiveerd | string |
| Tijdsstempel, je krijgt enkel dossiers terug waarin er na deze datum nog activiteit was | string |
| Filter op rijksregisternummer (persoon). Let wel: dit vereist een extra parameter met info over welk formulierveld het rijksregisternummer bevat. Zie dit voorbeeld voor meer info. | string |
Form
Een formulier is een unieke instantie van een formuliertemplate of formulierdefinitie.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Verwijzingen (links) naar | Links (zie schema) |
| Lijst van bijlages die upgeload zijn binnen de context van het formulier | array met bijlages |
| Tijdsstempel ogenblik waarop het formulier is aangemaakt | string (date-time) |
| Dit is de inhoud van het ingevulde formulier, de structuur komt overeen met die van de opgebouwde formulierdefinitie of formuliertemplate | object |
| Verwijst naar de formulierdefinitie of formuliertemplate | FormDefinition |
| Unieke GUID voor het formulier | string |
|
| boolean |
| Tijdsstempel ogenblik waarop het formulier laatst is aangepast | string (date-time) |
| Versienummer van het formulier | integer (int32) |
FormDefinition
Een formulier is een unieke instantie van een formuliertemplate of formulierdefinitie.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Key van de formulierdefinitie of formuliertemplate | string |
| Naam of label van de formulierdefinitie of formuliertemplate | string |
FormList
Een formulier is een unieke instantie van een formuliertemplate of formulierdefinitie.
Eigenschap | Beschrijving | Formaat |
---|---|---|
|
| object |
| Verwijzingen (links) naar | Links (zie schema) |
Link
Dit beschrijft de verschillende eigenschappen van een link in OpenAPI, die gebruikt kan worden om naar andere resources te verwijzen, met metadata die helpt bij het begrijpen van de link, het type, de taal, het formaat, en meer.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| URL die de locatie aangeeft van de gelinkte resource. | string |
| Geeft de taal of taalvariant van de gelinkte resource aan, bijvoorbeeld "en" voor Engels of "nl" voor Nederlands | string |
| Een optionele eigenschap die een titel of beschrijving van de gelinkte resource biedt | string |
| Geeft het MIME-type of het formaat van de gelinkte resource aan, zoals "application/json" of "text/html" | string |
| Dit geeft aan of de link of de resource verouderd is en wanneer deze mogelijk niet meer ondersteund wordt | string |
| Verwijst naar een specifieke profiel of standaard die de link of resource volgt. Dit kan nuttig zijn om aan te geven hoe een resource zich gedraagt of welke specificaties het volgt | string |
| Dit is de naam van de link of de gekoppelde resource | string |
| Dit geeft aan of de link een sjabloon is (met placeholders die vervangen kunnen worden door specifieke waarden). De waarde is een boolean, wat betekent dat het ofwel | boolean |
Links
Verwijzingen (href
links) naar self
en gerelateerde items. Zie schema Link.
Milestone
Klik hier voor alle info over mijlpalen.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Verwijzingen (links) naar | Links (zie schema) |
| Tekstuele beschrijving van de mijlpaal zoals opgesteld in de dossierytpe instellingen | string |
| Unieke GUID voor de mijlpaal | string |
| Key van het event in de workflow waarvoor een mijlpaal is geactiveerd | string |
| Tijdsstempel ogenblik waarop de mijlpaal is bereikt | string (date-time) |
| Naam van de mijlpaal zoals gedefinieerd in de workflow | string |
MilestoneList
Klik hier voor alle info over mijlpalen.
Eigenschap | Beschrijving | Formaat |
---|---|---|
_embedded |
| object |
_links | Verwijzingen (links) naar | Links (zie schema) |
NotifyEventActionRequest
Je kan een message uitsturen naar een specifiek dossier. Deze message wordt opgevangen door een message event in de workflow. Indien zich daar een process token bevindt, dan gaat deze verder binnen de workflow en volgt uitvoering van de gewenste actie. Zie het overzicht van endpoints en functies voor alle info.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Eventuele extra parameters die je wil meegeven met de request | object |
| Key van de message die je wil uitsturen naar het dossier | string |
| Type request. Voorlopig is hier slechts één optie | enum (NOTIFY_EVENT) |
PageMetadata
Dit geeft informatie over de paginering van de resultatenlijst.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Specifieke pagina uit de resultatenlijst (zero index based, eerste pagina heeft index '0') | integer (int64) |
| Maximaal aantal elementen per pagina in de resultatenlijst | integer (int64) |
| Totaal aantal elementen in de resultatenlijst | integer (int64) |
| Totaal aantal pagina’s in de resultatenlijst | integer (int64) |
PagedDossierList
Algemene structuur van de gepagineerde resultatenlijst.
Eigenschap | Beschrijving | Formaat |
---|---|---|
|
| object |
| Verwijzingen (links) naar | Links (zie schema) |
| Pagineringsdetails voor de dossierlijst | PageMetadata (zie schema) |
Task
Klik hier voor alle info over gebruikerstaken.
Eigenschap | Beschrijving | Formaat |
---|---|---|
| Verwijzingen (links) naar | Links |
|
| boolean |
| Gebruiker aan wie de taak is toegewezen | User (zie schema) |
| Tijdsstempel ogenblik waarop de taak is aangemaakt | string (date-time) |
| Begeleidende tekst voor popup bij taken van het type bevestigingstaak | string |
| Tijdsstempel due date of opleveringsdatum, speelt een rol in toewijzing gebruikerstaken en sortering takenlijst backoffice. | string (date-time) |
| Unieke GUID voor de taak | string |
| Naam van de taak zoals gedefinieerd in de workflow | string |
|
| enum (DOCUMENT,COMMUNICATION,POP_UP,SELECT,DOWNLOAD,PAYMENT) |
TaskList
Klik hier voor alle info over gebruikerstaken.
Eigenschap | Beschrijving | Formaat |
---|---|---|
|
| object |
| Verwijzingen (links) naar | Links |
User
Informatie over de specifieke gebruiker.
Eigenschap | Beschrijving | Formaat |
---|---|---|
|
| boolean |
| Unieke GUID voor de ingelogde gebruiker | string |
| Naam van de gebruiker | string |