Idempotencia de la API

Cada solicitud que no sea GET necesita un encabezado Idempotency-Key. Utilice una clave estable por cada escritura lógica para que los reintentos de red sean seguros.

Última actualización - 5 de junio de 2026 Tiempo de lectura - 4 min Autor - Tom Rushmore

Obligatorio en las escrituras

Envíe Idempotency-Key en cada solicitud POST, PUT, PATCH y DELETE. Las claves faltantes devuelven 400 idempotency_key_required.

Idempotency-Key: order-5501234567890-assignment-1

Comportamiento de la repetición

Misma clave, mismo endpoint, mismo cuerpo: la API repite la respuesta exitosa y no vuelve a escribir.
Misma clave con un cuerpo diferente: la API devuelve 409 idempotency_conflict.
Misma clave mientras la primera solicitud todavía se está ejecutando: la API devuelve 409 idempotency_conflict_in_progress.
Las claves caducan después de 24 horas. Genere una clave nueva para cada operación lógica nueva.

Documentación de la API

Empieza aquí

Guía rápida de la API

Haz ping a la API, importa un recurso, mapéalo a un producto y asigna acceso a un pedido.

Referencia

Referencia de endpoints

Revisa los endpoints disponibles para recursos, asignaciones, pedidos, cambios de acceso y estado.

¿Te ha resultado útil?

¿Sigues con dudas? Escribe a admin@alvaapps.com.

Última actualización 2026-06-05