API & export
De gegevens zijn van de klant. Volledig, gedocumenteerd, zonder exit-kosten.
Endpoints
API-sleutels zijn per werkruimte begrensd, met eigen rechten en snelheidslimiet.
| Methode | Pad | Doet | Status |
|---|---|---|---|
| GET | /api/v1/assets | Middelen met huidige positie, herkomst en betrouwbaarheid | live |
| GET | /api/v1/assets?format=csv | Zelfde data als CSV-download | live |
| GET | /api/v1/assets/{id}/sightings | Waarnemingshistorie over een periode | gepland |
| GET | /api/v1/geofences | Zones en hun instellingen | gepland |
| GET | /api/v1/events | Zone-gebeurtenissen — de auditsporen | gepland |
| GET | /api/v1/balances | Saldi en demurrage per klant | gepland |
| POST | /api/v1/ingest | Batch waarnemingen van lezers (arrays, idempotent) | gepland |
| POST | /api/v1/exports | Volledige export als asynchrone taak → getekende URL | gepland |
Toegang delegeren
Niemand anders in deze categorie heeft dit.
De klant kan zijn eigen verzekeraar, accountant of toezichthouder een sleutel geven op zijn eigen gegevens: begrensd tot bepaalde middelen of periodes, met een einddatum, en op elk moment in te trekken.
Dat is een verplichting uit de Data Act — en tegelijk precies wat een schadeclaim of een PPWR-indiening nodig heeft. Verplichting omgezet in functionaliteit.
bereik per middeleinddatumintrekbaarvolledig auditspoor
Weggaan
Het beleid, niet een clausule.
- Volledige export, niet achter een betaalmuur. JSON en CSV, cursor-gepagineerd, alle historie.
- Geen exit-kosten. Data eruit halen kost niets, ook niet bij opzegging.
- De tags blijven van de klant. Ze zijn onder onze licentie geregistreerd maar aan de klant geleverd; opzeggen maakt de hardware niet waardeloos.
- Bewaartermijnen per klant instelbaar, uitgevoerd als het verwijderen van partities — de gegevens zijn dan echt weg, niet gemarkeerd.
Wat we bewust niet loggen
Als chauffeurstelefoons als mobiele lezer werken, is de combinatie van lezer-id en tijdstip herleidbaar tot waar een medewerker was en wanneer. Dat is persoonsgegeven onder de AVG en medezeggenschapsmaterie onder de WOR. Het staat daarom in een aparte tabel met een kortere bewaartermijn en het bereikt de klant-API niet — ook niet via deze endpoints. Er is geen leespad naartoe.