Kies een integratiemodel

Een bevoegde persoon voltooit de inspectie altijd in de TrakarIA-applicatie. De eerste keuze is wie het dossier maakt en de inspectie voorbereidt. Een API-koppeling en een knop naar de inspectie zijn afzonderlijke keuzes.

Model	Je systeem	De medewerker	Geschikt voor
Alleen applicatie	Geen publieke API; geen reserveringssynchronisatie	Kiest of maakt voertuig, start uitgifte en retour en vult gegevens in TrakarIA in	Team zonder koppeling met verhuursoftware
API, zonder knop	Synchroniseert voertuig en dossier in de planning en bereidt beide inspecties voor	Vindt de voorbereide inspectie in TrakarIA en valideert haar	Gekoppelde software; team werkt al in TrakarIA
API met directe opening	Dezelfde oproepen plus een knop naar tijdelijke launch_url	Opent de juiste workflow, meldt zich aan en valideert	Geïntegreerde ervaring in eigen software

Cycli die alleen in de applicatie zijn gemaakt, worden niet automatisch /v1/rentals wanneer je later een API toevoegt.

De gekoppelde reis

1. Je backend stuurt voertuig- en Rental-context met de groepssleutel. De Rental verschijnt direct in de planning. Alleen het externe voertuig-ID is in de body verplicht; de rest mag vooraf, bij uitgifte of later met een nieuwere revisie komen. Doe dit server-side.
2. De backend roept POST /v1/rentals/{rental_id}/inspections aan met departure of return en Idempotency-Key.
3. De reactie bevat inspectie-ID en een tijdelijke launch_url; je app kan die via normale navigatie of een nieuw tabblad openen.
4. De medewerker meldt zich zo nodig aan. TrakarIA controleert persoonlijke groepsrechten.
5. Na validatie ontvangt de backend een ondertekende gebeurtenis of herstelt via GET /v1/events, en leest vervolgens het rapport.

Vernieuw een verlopen link met POST /v1/inspections/{inspection_id}/launch. Het is navigatiehulp, geen toegangstoken: houd hem uit logs, analytics en publieke pagina’s. TrakarIA kan ook in je applicatie worden ingebed; neem contact op met support om het domein te laten beoordelen en toestaan. Niet-goedgekeurde applicaties blijven geblokkeerd.

Je applicatie kan bij de overdracht stoppen

Als medewerkers al in TrakarIA werken, is geen knop nodig. De backend heeft nog steeds een API-sleutel nodig om voertuig en dossier te synchroniseren en de inspectie voor te bereiden. De medewerker hervat haar vanuit de TrakarIA-applicatie. Een Checkout zonder gekozen planning toont beschikbare reserveringen van het voertuig en laat ook een onafhankelijke walk-in toe. De koppeling levert context maar blokkeert de fysieke overdracht nooit.

Wanneer callbacks toevoegen?

Gebruik webhooks voor snelle reacties. Verifieer, dedupliceer en haal daarna de actuele resource op. GET /v1/events biedt herstel. rental.departure.completed betekent dat vertrek-JSON gereed is; rental.return.completed betekent dat vergelijkings-JSON gereed is. PDF-gereedheid kan later volgen.