Idempotencia

Las operaciones compatibles declaran la cabecera Idempotency-Key y su obligatoriedad en el contrato OpenAPI. Consultá la referencia API antes de implementar para confirmar la superficie vigente.

La clave admite entre 1 y 200 caracteres y debe cumplir este patrón:

^[A-Za-z0-9._~:+-]+$

Usá una clave nueva y estable para cada operación lógica. Un ejemplo ficticio:

Idempotency-Key: order-pos-2026-000042

Replay y conflictos

Al crear una orden, una repetición completada puede devolver la respuesta original con:

Idempotent-Replayed: true

El cuerpo también informa meta.idempotent_replay. La API puede responder 409 si una clave se reutiliza con otro body o si la operación sigue en proceso. En la creación de órdenes, 409 también puede representar referencia duplicada o stock insuficiente.

Nota

El contrato no declara cuánto tiempo se conservan las claves. La ventana de retención queda pendiente de documentación.

Entregas de webhooks

La deduplicación de webhooks usa X-Wendo-Delivery-Id, no Idempotency-Key. Guardá el delivery ID en la misma transacción que el efecto de negocio y, ante un duplicado, respondé 2xx sin repetir ese efecto. Consultá idempotencia y duplicados de webhooks para ver el flujo completo y sus límites anti-replay.