Developers
Van API request naar traceerbaar resultaat
Een Nederlandse introductie tot authenticatie, Operations, callbacks en de auditsporen van de CustomsLens API.
De technische levenscyclus
Payloadvelden en schemas staan in de Engelstalige API-documentatie. Hier staat hoe een Consumer een aanvraag betrouwbaar door de levenscyclus volgt.
Authenticeren met API Keys
Een API Key authenticeert de API Consumer en koppelt elke aanvraag aan één Customer. Keys horen alleen aan de serverkant van de integratie.
Direct resultaat of Operation
Een synchrone service antwoordt direct. Langer werk wordt geaccepteerd als Operation met een operationId en een eindstatus.
Callback ontvangen
De API Consumer geeft per asynchrone aanvraag een HTTPS callback-URL op. CustomsLens verstuurt het resultaat als geauthenticeerde callback.
Resultaat terugvinden
Als fallback en voor integratiediagnose blijft het resultaat opvraagbaar via GET /operations/{operationId}.
Requests en afleveringen terugvinden
Iedere geauthenticeerde API-aanvraag krijgt een request-ID. De requestlog laat zien welke API Key de aanvraag deed en welke HTTP-status volgde.
Iedere callback-afleverpoging heeft een delivery-ID. Afleveringen tonen de poging, de reactie van het endpoint en een eventuele foutreden, zodat een API Consumer het leveringsverloop kan onderzoeken of een vastgelegde aflevering opnieuw kan starten.
De Douane-keten blijft herkenbaar
Voor HTG-processen bewaart CustomsLens de ongewijzigde Douane-berichtketen als auditbron. Requests, Operations, callbacks en afleverpogingen zijn daarnaast via hun eigen publieke identifiers te volgen, zonder dat deze pagina payloads, geheime waarden of interne logvelden publiceert.
Bekijk het volledige contract
Endpoint-, payload- en schema-informatie staat in de Engelse API-reference.
GET /operations/{operationId}