|
|
|
|
|
Beheerdersmeldingen zijn meldingen die gelogd worden voor een beheerder van de applicatie. Ze gaan over fouten waar een gebruiker meestal niets aan kan doen, maar een applicatiebeheerder wel. Denk bijvoorbeeld aan premieberekeningen die niet uitgevoerd kunnen worden door een fout in de productinrichting.
Beheerdersmeldingen waren al lange tijd beschikbaar in DIAS On Assurantie onder . Deze meldingen zijn nu ook beschikbaar via WebAPI‑ingangen, onder de naam beheerdersmeldingen.
API-ingangen
GET beheer/api/v1/beheerdersmeldingen – levert een lijst van beheerdersmeldingen.
GET beheer/api/v1/beheerdersmeldingen/{id} – levert een enkele beheerdersmelding inclusief volledige inhoud.
PUT beheer/api/v1/beheerdersmeldingen/afhandelen – markeert een beheerdersmelding als afgehandeld.
Voorbeeld: lijst van beheerdersmeldingen
{
"Data": [
{
"MeldingId": 0,
"Tijdstip": "2025-11-04T09:08:13.729Z",
"TypeMelding": "string",
"ZwaarteId": "NotSet",
"Omschrijving": "string",
"IsAfgehandeld": true
}
],
"Paging": {
"PageNo": 0,
"PageSize": 0,
"PageCount": 0,
"TotalRecordCount": 0
}
}
Velden
- MeldingId: de unieke identifier van de melding (64‑bits nummer).
- Tijdstip: het tijdstip waarop de melding is opgetreden, in Nederlandse tijd.
- TypeMelding: indicator van het onderdeel van de programmatuur waarin het probleem is opgetreden.
- ZwaarteId: de ernst van de melding (Informatie, Waarschuwing, Fout, ErnstigeFout).
- Omschrijving: korte omschrijving van de melding.
- IsAfgehandeld: geeft aan of de melding als afgehandeld is gemarkeerd.
Queryparameters
isafgehandeld: optioneel, filter op afgehandelde of niet‑afgehandelde meldingen.
tijdstipvanaf: optioneel, lever meldingen vanaf een opgegeven datum/tijd.
zwaarteid: optioneel, filter op meldingen van een bepaalde zwaarte.
limit: optioneel, standaard 50, maximaal aantal meldingen dat wordt geleverd.
Voorbeeld: enkele beheerdersmelding
{
"MeldingId": 0,
"Tijdstip": "2025-11-04T09:08:13.731Z",
"TypeMelding": "string",
"ZwaarteId": "NotSet",
"Omschrijving": "string",
"IsAfgehandeld": true,
"Inhoud": "string"
}
Inhoud: wordt alleen geleverd bij de detail‑aanroep en bevat de volledige inhoud van de beheerdersmelding.
{
"MeldingId": 0,
"ResourceId": "00000000-0000-0000-0000-000000000000"
}
Afhandelen
Bij het afhandelen van een melding via PUT beheer/api/v1/beheerdersmeldingen/afhandelen moet de volgende body worden meegegeven:
Als de aanroep succesvol verloopt, wordt de opgegeven melding als afgehandeld gemarkeerd. Als de melding al als afgehandeld was, verandert er niets. Het resultaat bevat het MeldingId van de afgehandelde melding:
{
"MeldingId": 0
}
Bij een ongeldig of ontbrekend MeldingId wordt een Bad Request teruggegeven met foutcode BestaatNiet of MeldingVerplicht.