Routes
Alle paden zijn ten opzichte van https://api.beveiligingx.nl/api/v1/beveiliging. De volledige schema's staan in de specificatie.
Stamgegevens
Opdrachtgevers, objecten met coördinaten en normen, teams en beveiligers.
GET /opdrachtgevers
Opdrachtgevers
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
actief | query | Alleen actieve (true) of inactieve (false). Verwijderde staan erin met verwijderd_op. |
Antwoord
{
"data": [
{
"id": 7,
"naam": "Havenbedrijf Zuid",
"soort": "direct",
"contactpersoon": "A. de Vries",
"email": "beveiliging@havenzuid.example",
"actief": true,
"factuuradres": {
"adres": "Kade 12",
"postcode": "3011 AA",
"plaats": "Rotterdam"
},
"btw_nummer": "NL000000000B01",
"betaaltermijn_dagen": 30,
"aangemaakt_op": "2026-01-05T09:12:00+01:00",
"gewijzigd_op": "2026-05-30T14:02:11+02:00",
"verwijderd_op": null
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
GET /opdrachtgevers/{id}
Een opdrachtgever
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Antwoord
{
"data": {
"id": 7,
"naam": "Havenbedrijf Zuid",
"soort": "direct",
"contactpersoon": "A. de Vries",
"email": "beveiliging@havenzuid.example",
"actief": true,
"factuuradres": {
"adres": "Kade 12",
"postcode": "3011 AA",
"plaats": "Rotterdam"
},
"btw_nummer": "NL000000000B01",
"betaaltermijn_dagen": 30,
"aangemaakt_op": "2026-01-05T09:12:00+01:00",
"gewijzigd_op": "2026-05-30T14:02:11+02:00",
"verwijderd_op": null
}
}
GET /objecten
Objecten met coördinaten, bezettingsnormen en teams
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
actief | query | true is open, false is gesloten. |
opdrachtgever | query | Het id van de opdrachtgever. |
team | query | Objecten die dit team vandaag draait. |
Antwoord
{
"data": [
{
"id": 12,
"naam": "Distributiecentrum Oost",
"adres": "Logistiekweg 4, Utrecht",
"opdrachtgever_id": 7,
"opdrachtgever_label": null,
"coordinaten": {
"lat": 52.0907,
"lng": 5.1214
},
"geofence_meters": 150,
"rondes_per_dienst": 2,
"actief": true,
"gesloten_op": null,
"normen": [
{
"id": 3,
"weekdag": null,
"dienstsoort": "dag",
"minimum": 2,
"gewenst": null,
"ernst": "waarschuwing",
"alleen_toegestaan": false,
"geldig_van": "2026-01-01",
"geldig_tot": null
}
],
"teams": [
{
"team_id": 4,
"van": "2026-01-01",
"tot": null
}
],
"aangemaakt_op": "2026-01-05T09:20:00+01:00",
"gewijzigd_op": "2026-03-02T11:00:00+01:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
GET /objecten/{id}
Een object
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Antwoord
{
"data": {
"id": 12,
"naam": "Distributiecentrum Oost",
"adres": "Logistiekweg 4, Utrecht",
"opdrachtgever_id": 7,
"opdrachtgever_label": null,
"coordinaten": {
"lat": 52.0907,
"lng": 5.1214
},
"geofence_meters": 150,
"rondes_per_dienst": 2,
"actief": true,
"gesloten_op": null,
"normen": [
{
"id": 3,
"weekdag": null,
"dienstsoort": "dag",
"minimum": 2,
"gewenst": null,
"ernst": "waarschuwing",
"alleen_toegestaan": false,
"geldig_van": "2026-01-01",
"geldig_tot": null
}
],
"teams": [
{
"team_id": 4,
"van": "2026-01-01",
"tot": null
}
],
"aangemaakt_op": "2026-01-05T09:20:00+01:00",
"gewijzigd_op": "2026-03-02T11:00:00+01:00"
}
}
GET /teams
Teams met leden en objecten
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
actief | query | Alleen actieve of inactieve teams. |
Antwoord
{
"data": [
{
"id": 4,
"naam": "Ploeg Noord",
"soort": "ploeg",
"actief": true,
"planningscyclus": "weeks",
"cyclus_weken": 4,
"leden": [
{
"beveiliger_id": 31,
"rol": "lid",
"van": "2026-01-01",
"tot": null
}
],
"objecten": [
{
"object_id": 12,
"van": "2026-01-01",
"tot": null
}
],
"aangemaakt_op": "2026-01-02T08:00:00+01:00",
"gewijzigd_op": "2026-04-14T10:30:00+02:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
GET /teams/{id}
Een team
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Antwoord
{
"data": {
"id": 4,
"naam": "Ploeg Noord",
"soort": "ploeg",
"actief": true,
"planningscyclus": "weeks",
"cyclus_weken": 4,
"leden": [
{
"beveiliger_id": 31,
"rol": "lid",
"van": "2026-01-01",
"tot": null
}
],
"objecten": [
{
"object_id": 12,
"van": "2026-01-01",
"tot": null
}
],
"aangemaakt_op": "2026-01-02T08:00:00+01:00",
"gewijzigd_op": "2026-04-14T10:30:00+02:00"
}
}
GET /beveiligers
Beveiligers (zonder BSN, IBAN, adres of documenten)
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
actief | query | Alleen actieve of inactieve beveiligers. |
team | query | Wie vandaag in dit team zit. |
Antwoord
{
"data": [
{
"id": 31,
"naam": "Mo Yilmaz",
"email": "mo.yilmaz@voorbeeld.example",
"personeelsnummer": "B-0031",
"contractsoort": "vast",
"zzp": false,
"uren_per_week": 38,
"in_dienst_sinds": "2024-03-01",
"actief": true,
"teams": [
4
],
"aangemaakt_op": "2024-02-20T10:00:00+01:00",
"gewijzigd_op": "2026-05-01T09:00:00+02:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
GET /beveiligers/{id}
Een beveiliger
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Antwoord
{
"data": {
"id": 31,
"naam": "Mo Yilmaz",
"email": "mo.yilmaz@voorbeeld.example",
"personeelsnummer": "B-0031",
"contractsoort": "vast",
"zzp": false,
"uren_per_week": 38,
"in_dienst_sinds": "2024-03-01",
"actief": true,
"teams": [
4
],
"aangemaakt_op": "2024-02-20T10:00:00+01:00",
"gewijzigd_op": "2026-05-01T09:00:00+02:00"
}
}
Diensten
Het rooster en de uitvoering; schrijven langs de planregels.
GET /diensten
Diensten: gepland, gepubliceerd en vervallen, met aan- en afmelden
Scope beveiliging.lezen. Ook als CSV of XML: ?formaat=csv|xml of Accept: text/csv / application/xml; de volgende pagina staat dan in de kop Link.
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
van | query | Vanaf deze dag (JJJJ-MM-DD), in de tijdzone van de organisatie. |
tot | query | Tot en met deze dag (JJJJ-MM-DD). |
object | query | Het id van het object. |
team | query | Het id van het team. |
beveiliger | query | Het id van de beveiliger. |
planstatus | query | concept, gepubliceerd of vervallen. |
uitvoering | query | gepland, aangemeld of afgerond. |
formaat | query | json (standaard), csv of xml. Accept: text/csv of application/xml werkt ook. |
Antwoord
{
"data": [
{
"id": 41,
"object_id": 12,
"team_id": 4,
"beveiliger_id": 31,
"contract_id": 6,
"planperiode_id": 20,
"dienstsoort": "dag",
"begint_op": "2026-06-01T07:00:00+02:00",
"eindigt_op": "2026-06-01T15:00:00+02:00",
"geplande_minuten": 480,
"planstatus": "gepubliceerd",
"uitvoering": "afgerond",
"bron": "handmatig",
"vervanging": null,
"aangemeld_op": "2026-06-01T06:54:00+02:00",
"aanmeldmethode": "geofence",
"geofence": "inside",
"afgemeld_op": "2026-06-01T15:20:00+02:00",
"afmelding_ontbreekt_sinds": null,
"gewerkte_minuten": 506,
"meerwerk": {
"minuten": 26,
"gevraagd_door": "Teamleider opdrachtgever",
"reden": "Laatste vrachtwagen te laat",
"geregistreerd_op": "2026-06-01T14:50:00+02:00"
},
"notities": null,
"aangemaakt_op": "2026-05-20T10:00:00+02:00",
"gewijzigd_op": "2026-06-01T15:20:02+02:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
POST /diensten
Een conceptdienst neerzetten
Zoals op het planbord. Met beveiliger_id oordeelt de regelmotor over de toewijzing: een blokkade weigert (422 planregels_blokkade), een waarschuwing weigert tot u force: true meestuurt (422 planregels_waarschuwing). Een dienst in een vastgezette periode kan niet (409 periode_vast).
Scope beveiliging.planning.schrijven
| Parameter | Waar | Betekenis |
|---|
Idempotency-Key | kop | Een eigen sleutel (1 tot 120 tekens) per schrijfverzoek. Hetzelfde verzoek met dezelfde sleutel binnen 24 uur krijgt het eerste antwoord terug (met Idempotent-Replayed: true) en doet niets opnieuw. Dezelfde sleutel met een ander verzoek is 422 idempotentie_conflict. |
Verzoek
{
"object_id": 12,
"dienstsoort": "dag",
"datum": "2026-06-01",
"begint": "07:00",
"eindigt": "15:00",
"beveiliger_id": 31
}
GET /diensten/{id}
Een dienst
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Antwoord
{
"data": {
"id": 41,
"object_id": 12,
"team_id": 4,
"beveiliger_id": 31,
"contract_id": 6,
"planperiode_id": 20,
"dienstsoort": "dag",
"begint_op": "2026-06-01T07:00:00+02:00",
"eindigt_op": "2026-06-01T15:00:00+02:00",
"geplande_minuten": 480,
"planstatus": "gepubliceerd",
"uitvoering": "afgerond",
"bron": "handmatig",
"vervanging": null,
"aangemeld_op": "2026-06-01T06:54:00+02:00",
"aanmeldmethode": "geofence",
"geofence": "inside",
"afgemeld_op": "2026-06-01T15:20:00+02:00",
"afmelding_ontbreekt_sinds": null,
"gewerkte_minuten": 506,
"meerwerk": {
"minuten": 26,
"gevraagd_door": "Teamleider opdrachtgever",
"reden": "Laatste vrachtwagen te laat",
"geregistreerd_op": "2026-06-01T14:50:00+02:00"
},
"notities": null,
"aangemaakt_op": "2026-05-20T10:00:00+02:00",
"gewijzigd_op": "2026-06-01T15:20:02+02:00"
}
}
PATCH /diensten/{id}
Een conceptdienst wijzigen
Alleen een conceptdienst die nog niet loopt (anders 409 geen_concept). Wat u niet meestuurt blijft staan. Een andere tijd, dag, soort, object of beveiliger gaat langs de regelmotor.
Scope beveiliging.planning.schrijven
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Idempotency-Key | kop | Een eigen sleutel (1 tot 120 tekens) per schrijfverzoek. Hetzelfde verzoek met dezelfde sleutel binnen 24 uur krijgt het eerste antwoord terug (met Idempotent-Replayed: true) en doet niets opnieuw. Dezelfde sleutel met een ander verzoek is 422 idempotentie_conflict. |
Verzoek
{
"begint": "08:00",
"eindigt": "16:00"
}
POST /diensten/{id}/toewijzen
Een beveiliger toewijzen
Langs de regelmotor, net als slepen op het planbord. Ook op een gepubliceerde dienst, zolang hij niet vervallen of gedraaid is en de periode niet vaststaat.
Scope beveiliging.planning.schrijven
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Idempotency-Key | kop | Een eigen sleutel (1 tot 120 tekens) per schrijfverzoek. Hetzelfde verzoek met dezelfde sleutel binnen 24 uur krijgt het eerste antwoord terug (met Idempotent-Replayed: true) en doet niets opnieuw. Dezelfde sleutel met een ander verzoek is 422 idempotentie_conflict. |
Verzoek
{
"beveiliger_id": 31
}
POST /diensten/{id}/vrijgeven
De beveiliger van een dienst halen (open dienst)
De dienst blijft staan zonder beveiliger: een gat dat de planner nog vult.
Scope beveiliging.planning.schrijven
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Idempotency-Key | kop | Een eigen sleutel (1 tot 120 tekens) per schrijfverzoek. Hetzelfde verzoek met dezelfde sleutel binnen 24 uur krijgt het eerste antwoord terug (met Idempotent-Replayed: true) en doet niets opnieuw. Dezelfde sleutel met een ander verzoek is 422 idempotentie_conflict. |
Verzoek
{
"force": false
}
POST /diensten/{id}/vervallen
Een conceptdienst laten vervallen
Vervallen, niet verwijderen: de geschiedenis van de dienst blijft staan. Alleen een conceptdienst.
Scope beveiliging.planning.schrijven
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Idempotency-Key | kop | Een eigen sleutel (1 tot 120 tekens) per schrijfverzoek. Hetzelfde verzoek met dezelfde sleutel binnen 24 uur krijgt het eerste antwoord terug (met Idempotent-Replayed: true) en doet niets opnieuw. Dezelfde sleutel met een ander verzoek is 422 idempotentie_conflict. |
Verzoek
{
"reden": "Opdrachtgever zegde de avond af."
}
Uren
Gewerkte diensten met toeslagregels uit de loonspecificatie.
GET /uren
Gewerkte diensten met minuten, meerwerk en toeslagregels
Scope beveiliging.uren.lezen. Ook als CSV of XML: ?formaat=csv|xml of Accept: text/csv / application/xml; de volgende pagina staat dan in de kop Link.
Scope beveiliging.uren.lezen
| Parameter | Waar | Betekenis |
|---|
van | query | Vanaf deze dag (JJJJ-MM-DD), in de tijdzone van de organisatie. |
tot | query | Tot en met deze dag (JJJJ-MM-DD). |
object | query | Het id van het object. |
team | query | Het id van het team. |
beveiliger | query | Het id van de beveiliger. |
formaat | query | json (standaard), csv of xml. Accept: text/csv of application/xml werkt ook. |
Antwoord
{
"data": [
{
"dienst_id": 41,
"beveiliger_id": 31,
"object_id": 12,
"team_id": 4,
"datum": "2026-06-01",
"dienstsoort": "nacht",
"begint_op": "2026-06-01T23:00:00+02:00",
"eindigt_op": "2026-06-02T07:00:00+02:00",
"aangemeld_op": "2026-06-01T22:56:00+02:00",
"afgemeld_op": "2026-06-02T07:30:00+02:00",
"geplande_minuten": 480,
"gewerkte_minuten": 514,
"meerwerk_minuten": 34,
"eindtijd_bevestigd_door_kantoor": false,
"specificatie": {
"id": 9,
"maand": "2026-06",
"versie": 1,
"status": "final"
},
"regels": [
{
"soort": "basis",
"omschrijving": "Basisuren",
"minuten": 480,
"uurloon_cent": 1650,
"percentage": null,
"bedrag_cent": 13200,
"regel": "cao art. 13",
"datum": "2026-06-01"
},
{
"soort": "toeslag",
"omschrijving": "Nachttoeslag",
"minuten": 420,
"uurloon_cent": 1650,
"percentage": 30,
"bedrag_cent": 3465,
"regel": "cao art. 21",
"datum": "2026-06-01"
}
],
"gewijzigd_op": "2026-06-02T07:30:05+02:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
Verlof en beschikbaarheid
Verlof en afwezigheid, en wanneer een beveiliger kan.
PUT /beveiligers/{id}/beschikbaarheid
Beschikbaarheid zetten
Per weekdag (0 is zondag) en per datum. Werkt zoals in de app van de beveiliger: niveau no is niet beschikbaar; een datum vervangt wat er voor die datum stond.
Scope beveiliging.planning.schrijven
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Idempotency-Key | kop | Een eigen sleutel (1 tot 120 tekens) per schrijfverzoek. Hetzelfde verzoek met dezelfde sleutel binnen 24 uur krijgt het eerste antwoord terug (met Idempotent-Replayed: true) en doet niets opnieuw. Dezelfde sleutel met een ander verzoek is 422 idempotentie_conflict. |
Verzoek
{
"weekdagen": [
{
"weekdag": 0,
"beschikbaar": false,
"niveau": "no"
}
],
"uitzonderingen": [
{
"datum": "2026-06-12",
"beschikbaar": false,
"notitie": "Bruiloft"
}
]
}
GET /verlof
Verlof en afwezigheid
Scope beveiliging.lezen. Ook als CSV of XML: ?formaat=csv|xml of Accept: text/csv / application/xml; de volgende pagina staat dan in de kop Link.
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
van | query | Vanaf deze dag (JJJJ-MM-DD), in de tijdzone van de organisatie. |
tot | query | Tot en met deze dag (JJJJ-MM-DD). |
beveiliger | query | Het id van de beveiliger. |
status | query | pending, approved, rejected, active (lopende ziekte), withdrawn, cancelled of revoked. |
soort | query | vacation, unpaid, special of sick. |
formaat | query | json (standaard), csv of xml. Accept: text/csv of application/xml werkt ook. |
Antwoord
{
"data": [
{
"id": 55,
"beveiliger_id": 31,
"soort": "vacation",
"van": "2026-07-13",
"tot": "2026-07-24",
"status": "approved",
"reden": "Zomervakantie",
"beoordeeld_op": "2026-05-02T10:11:00+02:00",
"aangemaakt_op": "2026-04-28T19:40:00+02:00",
"gewijzigd_op": "2026-05-02T10:11:00+02:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
POST /verlof
Verlof aanvragen namens een beveiliger
Dezelfde toets op overlap als in de app. Kantoor beoordeelt; dat komt terug als verlof.goedgekeurd of verlof.afgewezen.
Scope beveiliging.verlof.schrijven
| Parameter | Waar | Betekenis |
|---|
Idempotency-Key | kop | Een eigen sleutel (1 tot 120 tekens) per schrijfverzoek. Hetzelfde verzoek met dezelfde sleutel binnen 24 uur krijgt het eerste antwoord terug (met Idempotent-Replayed: true) en doet niets opnieuw. Dezelfde sleutel met een ander verzoek is 422 idempotentie_conflict. |
Verzoek
{
"beveiliger_id": 31,
"soort": "vacation",
"van": "2026-07-13",
"tot": "2026-07-24",
"reden": "Zomervakantie"
}
GET /verlof/{id}
Een verlofaanvraag
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Antwoord
{
"data": {
"id": 55,
"beveiliger_id": 31,
"soort": "vacation",
"van": "2026-07-13",
"tot": "2026-07-24",
"status": "approved",
"reden": "Zomervakantie",
"beoordeeld_op": "2026-05-02T10:11:00+02:00",
"aangemaakt_op": "2026-04-28T19:40:00+02:00",
"gewijzigd_op": "2026-05-02T10:11:00+02:00"
}
}
GET /beschikbaarheid
Beschikbaarheid per weekdag en per datum
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
van | query | Vanaf deze dag (JJJJ-MM-DD), in de tijdzone van de organisatie. |
tot | query | Tot en met deze dag (JJJJ-MM-DD). |
beveiliger | query | Het id van de beveiliger. |
Antwoord
{
"data": [
{
"id": 301,
"beveiliger_id": 31,
"weekdag": 6,
"datum": null,
"beschikbaar": false,
"niveau": "no",
"notitie": null,
"reistijd_minuten": null,
"gewijzigd_op": "2026-05-10T12:00:00+02:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
Operatie
Bevindingen en rondes.
GET /bevindingen
Bevindingen (zonder foto)
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
van | query | Vanaf deze dag (JJJJ-MM-DD), in de tijdzone van de organisatie. |
tot | query | Tot en met deze dag (JJJJ-MM-DD). |
object | query | Het id van het object. |
dienst | query | Het id van de dienst. |
status | query | De stand van de bevinding. |
risico | query | Het risico van de bevinding. |
Antwoord
{
"data": [
{
"id": 501,
"dienst_id": 41,
"object_id": 12,
"beveiliger_id": 31,
"ronde_id": 77,
"controlepunt_id": 9,
"categorie": "deur",
"plaats": "Nooduitgang hal B",
"risico": "midden",
"politie_nodig": false,
"omschrijving": "Nooduitgang stond open, gesloten en gemeld.",
"status": "open",
"locatie": {
"lat": 52.0911,
"lng": 5.122
},
"gemeld_op": "2026-06-02T02:14:00+02:00",
"geescaleerd_op": null,
"escalatie_reden": null,
"reactie": null,
"beantwoord_op": null,
"afgesloten_op": null,
"heeft_foto": true,
"gewijzigd_op": "2026-06-02T02:14:00+02:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
GET /bevindingen/{id}
Een bevinding
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Antwoord
{
"data": {
"id": 501,
"dienst_id": 41,
"object_id": 12,
"beveiliger_id": 31,
"ronde_id": 77,
"controlepunt_id": 9,
"categorie": "deur",
"plaats": "Nooduitgang hal B",
"risico": "midden",
"politie_nodig": false,
"omschrijving": "Nooduitgang stond open, gesloten en gemeld.",
"status": "open",
"locatie": {
"lat": 52.0911,
"lng": 5.122
},
"gemeld_op": "2026-06-02T02:14:00+02:00",
"geescaleerd_op": null,
"escalatie_reden": null,
"reactie": null,
"beantwoord_op": null,
"afgesloten_op": null,
"heeft_foto": true,
"gewijzigd_op": "2026-06-02T02:14:00+02:00"
}
}
GET /bevindingen/{id}/foto
Een getekende link naar de foto (vijf minuten)
Scope beveiliging.bevindingen.foto
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Antwoord
{
"data": {
"url": "https://api.beveiligingx.nl/api/v1/beveiliging/bevindingen/501/foto/bestand?organisatie=3&expires=1780363200&signature=6b1d...",
"verloopt_op": "2026-06-02T09:05:00+02:00",
"geldig_minuten": 5
}
}
GET /bevindingen/{id}/foto/bestand
De foto achter een getekende link
Geen sleutel: de handtekening in de link is de toegang en verloopt na vijf minuten. Neem de link letterlijk over uit GET /bevindingen/{id}/foto.
Zonder sleutel
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
organisatie | query | Staat in de getekende link. |
expires | query | Staat in de getekende link. |
signature | query | Staat in de getekende link. |
GET /rondes
Rondes met de scans van de controlepunten
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
van | query | Vanaf deze dag (JJJJ-MM-DD), in de tijdzone van de organisatie. |
tot | query | Tot en met deze dag (JJJJ-MM-DD). |
dienst | query | Het id van de dienst. |
object | query | Het id van het object. |
status | query | pending, active, interrupted of completed. |
Antwoord
{
"data": [
{
"id": 77,
"dienst_id": 41,
"volgnummer": 1,
"status": "completed",
"gepland_op": null,
"gestart_op": "2026-06-02T01:00:00+02:00",
"onderbroken_op": null,
"onderbreking_reden": null,
"hervat_op": null,
"afgerond_op": "2026-06-02T01:42:00+02:00",
"scans": [
{
"id": 900,
"controlepunt_id": 9,
"controlepunt": "Hal B noord",
"status": "ok",
"gescand_op": "2026-06-02T01:12:00+02:00",
"storing": null,
"geofence": "inside"
}
],
"gewijzigd_op": "2026-06-02T01:42:00+02:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
GET /rondes/{id}
Een ronde
Scope beveiliging.lezen
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Antwoord
{
"data": {
"id": 77,
"dienst_id": 41,
"volgnummer": 1,
"status": "completed",
"gepland_op": null,
"gestart_op": "2026-06-02T01:00:00+02:00",
"onderbroken_op": null,
"onderbreking_reden": null,
"hervat_op": null,
"afgerond_op": "2026-06-02T01:42:00+02:00",
"scans": [
{
"id": 900,
"controlepunt_id": 9,
"controlepunt": "Hal B noord",
"status": "ok",
"gescand_op": "2026-06-02T01:12:00+02:00",
"storing": null,
"geofence": "inside"
}
],
"gewijzigd_op": "2026-06-02T01:42:00+02:00"
}
}
Dossier
Kwalificaties met vervaldatum (eigen scope).
GET /beveiligers/{id}/kwalificaties
De kwalificaties van een beveiliger
Scope beveiliging.dossier.lezen
| Parameter | Waar | Betekenis |
|---|
id | pad | Het id. |
Antwoord
{
"data": [
{
"id": 88,
"beveiliger_id": 31,
"soort": "wpbr_pas",
"omschrijving": "WPBR-legitimatiebewijs (grijze pas)",
"nummer": "P123456",
"geldig_tot": "2027-02-28",
"verlopen": false,
"beoordeling": "verified",
"beoordeeld_op": "2026-02-01T10:00:00+01:00",
"gewijzigd_op": "2026-02-01T10:00:00+01:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
GET /kwalificaties
Kwalificaties met vervaldatum
Scope beveiliging.dossier.lezen
| Parameter | Waar | Betekenis |
|---|
beveiliger | query | Het id van de beveiliger. |
soort | query | wpbr_pas, vog, screening, diploma, ehbo of bhv. |
verloopt_voor | query | Alleen wat voor deze datum (JJJJ-MM-DD) verloopt. |
Antwoord
{
"data": [
{
"id": 88,
"beveiliger_id": 31,
"soort": "wpbr_pas",
"omschrijving": "WPBR-legitimatiebewijs (grijze pas)",
"nummer": "P123456",
"geldig_tot": "2027-02-28",
"verlopen": false,
"beoordeling": "verified",
"beoordeeld_op": "2026-02-01T10:00:00+01:00",
"gewijzigd_op": "2026-02-01T10:00:00+01:00"
}
],
"links": {
"self": "...",
"volgende": null
},
"meta": {
"per_pagina": 100,
"aantal": 1,
"volgende_cursor": null
}
}
Specificatie
Deze specificatie zelf.
GET /openapi.json
Deze specificatie (OpenAPI 3.1, JSON)
Zonder sleutel