Idempotency

A Routal não expõe hoje um header Idempotency-Key. A alavanca de idempotência é o campo external_id de cada recurso (stop, vehicle), combinado com o padrão search-then-create.

Três padrões que cobrem 95% dos casos

1. Search-then-create por external_id — antes de criar, busque com POST /v2/stops/search por external_id; se existe, reuse.
2. Bulk-list-and-diff no arranque — no início do job, liste os recursos existentes uma vez, construa um Set em memória com os external_id, e compare com sua fonte.
3. Webhook handler idempotente — deduplique pela tripla (event_id, data.id, data.updated_at).

Ler a referência completa de Idempotency em inglês →