Documentación para desarrolladoresPrimeros pasos

Idempotencia

Reintenta POST /v1/pack sin crear un segundo trabajo.

Envía una cabecera Idempotency-Key con POST /v1/pack (o POST /v1/projects/{id}/pack). Si reintentas con la misma clave, obtienes el mismo trabajo y se cobra una sola vez.

Bash

curl -X POST https://runner.cargoduo.com/v1/pack \
  -H "Authorization: Bearer $CARGODUO_API_KEY" \
  -H "Idempotency-Key: order-1042-v1" \
  -H "Content-Type: application/json" \
  -d @request.json

Regla	Detalle
Ventana	24 horas, por organización
Clave	Cualquier cadena de hasta 128 caracteres: un UUID o tu ID de pedido
Repetición	El trabajo original, con `Idempotent-Replayed: true`. `200` si ya terminó, `202` si no
Demasiado larga	`400 idempotency_key_invalid`

Una clave por solicitud lógica. Si cambia el cuerpo, necesitas una clave nueva.

Ver también

Crear un trabajo de cargaValida la solicitud, reserva de tus créditos el precio máximo posible y pone un trabajo en cola.ErroresUna única estructura de error, códigos estables y reglas de reintento claras.

Ver también#

Ver también