Idempotency

Routal no expone hoy un header Idempotency-Key. La palanca de idempotencia es el campo external_id de cada recurso (stop, vehicle), combinado con el patrón search-then-create.

Tres patrones que cubren el 95% de los casos

1. Search-then-create por external_id — antes de crear, busca con POST /v2/stops/search por external_id; si existe, reúsalo.
2. Bulk-list-and-diff en arranque — al inicio del job, lista los recursos existentes una vez, construye un Set en memoria con los external_id, y diferencia contra tu fuente.
3. Webhook handler idempotente — deduplica por la tripleta (event_id, data.id, data.updated_at).

Leer la referencia completa de Idempotency en inglés →