Synchronisatie en fouten

Houd updates op volgorde

Upserts van voertuigen en Rental-dossiers zijn begrensd door je organisatie en external_id. Stuur bij creatie alle beschikbare context. Gebruik voor latere inhoudelijke wijzigingen source_revision of source_updated_at. Een strikt oplopend geheel revisienummer uit het bronsysteem heeft de voorkeur. Nadat een revisie is opgeslagen, kan een timestamp haar niet vervangen. Weggelaten eigenschappen behouden hun waarde; expliciet null wist alleen nullable velden. Onbekende eigenschappen worden geweigerd.

De Rental-regels blijven gelden: voertuigtoewijzing bevriest zodra de eerste inspectie begint; na vertrek bevriezen bepaalde planningsvelden; na voltooiing zijn alleen ondersteunde rapportcorrecties mogelijk. Bij een oudere of conflicterende update ontvang je een gestructureerde fout. Lees de huidige resource voordat je met een nieuwe revisie probeert.

Maak POST-commando’s veilig herhaalbaar

Iedere schrijvende POST vereist Idempotency-Key. Genereer een unieke waarde per bedoelde bewerking, behoud die bij netwerkherhalingen en gebruik haar nooit opnieuw met een andere body. De sleutel is organisatiegebonden en wordt zeven dagen bewaard. Dezelfde voltooide opdracht retourneert de oorspronkelijke succesvolle reactie; conflicterend hergebruik mislukt.

PUT per extern ID is deterministisch, maar versiemarkeringen blijven nodig voor gewijzigde updates. Maak geen nieuw extern ID om hetzelfde voertuig of dezelfde reservering opnieuw te proberen.

Verwerk fouten

API-fouten gebruiken application/problem+json met stabiele code, HTTP-status, leesbare detail, request_id, retryable en optionele veldfouten in errors. Leg voor support het request_id vast, maar nooit geheimen of bytes van privédocumenten.

De type-URL verwijst naar een publieke foutpagina. INVALID_API_KEY beschrijft bijvoorbeeld oorzaak en vervolgstap. Iedere middlewarecode heeft een pagina in alle ondersteunde talen.

Reactie	Actie
401	Controleer of de sleutel geldig, verlopen of ingetrokken is.
403	Controleer sleutelrechten en commerciële toegang van de organisatie.
409	Lees de huidige resource of het idempotentieconflict vóór aanpassing.
422	Corrigeer de genoemde velden; herhaal niet dezelfde ongeldige body.
429	Respecteer Retry-After en rate-limitheaders.
503	Probeer opnieuw op basis van retryable en eventueel Retry-After.

GET /v1/capabilities retourneert de effectieve quota, bestandslimieten en bewaartermijnen. De API-referentie is leidend voor de mogelijke reacties per route.