Rapporten en bewijs
Resultaten zijn bewust gescheiden in onveranderlijke rapportversies, officiële PDF’s en beschermd origineel bewijs. Volg deze stappen zonder afhankelijk te zijn van webhooktiming.
Stap 1 — Bepaal wat gereed is
Section titled “Stap 1 — Bepaal wat gereed is”GET /v1/rentals/{rental_id}/report is de actuele index. Een departure-rapport kan klaar zijn terwijl comparison nog ontbreekt.
| Menselijke validatie | Inspectiefase | Officieel rapporttype |
|---|---|---|
| Uitgifte voltooid | departure | departure |
| Retour voltooid | return | comparison |
Er is geen apart officieel type return: retour produceert de vergelijking met vertrek. Webhooks versnellen reconciliatie maar zijn niet de bron van waarheid; lees na een signaal de index opnieuw.
Stap 2 — Archiveer onveranderlijke JSON
Section titled “Stap 2 — Archiveer onveranderlijke JSON”- Gebruik
GET /v1/rentals/{rental_id}/reportsvoor alle versies. - Lees de gewenste versie via
GET /v1/reports/{report_id}. - Bewaar publiek rapport-ID, versie en inhoudshash bij je Rental-record.
Een ondersteunde correctie maakt een nieuwe onveranderlijke versie met nieuw ID en hash. Het vorige ID blijft naar de vorige versie verwijzen; overschrijf historie niet op basis van alleen Rental ID.
Stap 3 — Download de officiële PDF
Section titled “Stap 3 — Download de officiële PDF”GET /v1/reports/{report_id}/pdf retourneert bij 200 de bytes. 202 betekent dat generatie of herstel loopt; respecteer Retry-After en volg GET /v1/jobs/{job_id} of probeer de PDF-route opnieuw. De API streamt het bestand en geeft geen permanente opslag-URL.
Stap 4 — Lees origineel bewijs
Section titled “Stap 4 — Lees origineel bewijs”Roep GET /v1/inspections/{inspection_id}/evidence afzonderlijk aan voor vertrek en retour. Elk item bevat phase, kind, view, zone, eventuele schadekoppeling en openbaar content_path. GET /v1/evidence/{evidence_id}/content streamt één origineel beeld.
Het contract levert geen opslag-URL’s, contouren, maskers, coördinaten of geannoteerde renderingen. is_fresh_for_record is operationele herkomst voor de geauthenticeerde integratie en staat niet in gedeelde JSON, PDF of webhook.
Stap 5 — Download bewijs in batches
Section titled “Stap 5 — Download bewijs in batches”| Bereik | Endpoint | Inhoud |
|---|---|---|
| Eén inspectie | GET /v1/inspections/{inspection_id}/evidence/archive | Originele beelden van vertrek of retour |
| Hele Rental | GET /v1/rentals/{rental_id}/evidence/archive | Laatste vertrek- en retourbewijs in aparte mappen |
Elke ZIP bevat manifest.json met schone metadata: fase, aanzicht, zone, schadetype, ernst, getroffen delen, integriteitsvelden en relatief beeldpad. De beelden zijn de originele ongeannoteerde bytes; contouren, maskers, annotatielagen en private URL’s ontbreken altijd. De effectieve limiet staat als limits.max_evidence_archive_bytes in /v1/capabilities.
Stap 6 — Houd bijlagen apart
Section titled “Stap 6 — Houd bijlagen apart”Rental-bijlagen zijn privédocumenten uit je software, geen officieel inspectiebewijs. Upload en lees ze via /v1/rentals/{rental_id}/attachments. In de TrakarIA-workflow verschijnen ze automatisch onder Aanvullende documenten via een tijdelijke geautoriseerde link, zonder dubbele upload. Ze blijven alleen-lezen context en komen niet in bewijsarchieven of het officiële rapport.
Beeldverwerking blijft eenvoudig
Section titled “Beeldverwerking blijft eenvoudig”Je integratie classificeert geen inspectiefoto’s en wijst geen voertuigaanzichten toe. TrakarIA detecteert het aanzicht, groepeert overzicht en close-up en accepteert bruikbare detecties automatisch; de medewerker kan ze altijd corrigeren.
Bij handmatige correctie leidt de interface langs ieder beeld van het aanzicht en bewaart één consistente beslissing voor de volledige set. Verwerking die later eindigt kan een gevalideerd aanzicht niet stilzwijgend onvolledig maken. Een echte toevoeging, verwijdering of herindeling kan een gerichte controle vragen en opent direct het betrokken aanzicht. Dit interne proces maakt het publieke API-contract niet complexer.