Idempotency-Key y reintentos

Todo POST lleva la cabecera Idempotency-Key, de 1 a 200 caracteres. La misma clave con la misma petición devuelve la misma respuesta durante 24 horas, sin volver a hacerla. Así se puede repetir una petición cuando no se sabe si llegó.

1. 1Una clave nueva para cada cosa que quieres hacer, y la MISMA en cada reintento de esa cosa.
2. 2Repite con 429 y 503, esperando lo que dice Retry-After, y cuando la conexión se corta.
3. 3Un 409 in_progress es que la primera sigue en curso: repite en unos segundos con la misma clave.
4. 4Un 409 idempotency_conflict es que esa clave ya se usó con otra petición: es un fallo tuyo, no se repite.
5. 5No repitas 400, 401, 403, 404 ni 422: la respuesta no va a cambiar.

1CLAVE=$(uuidgen)2for intento in 1 2 3 4 5; do3  codigo=$(curl -s -D cabeceras.txt -o respuesta.json -w '%{http_code}' https://plataforma.ndx-one.com/api/v1/crm/contacts \4    -H "Authorization: Bearer $NDX_LLAVE" \5    -H "Content-Type: application/json" \6    -H "Idempotency-Key: $CLAVE" \7    -d '{ "firstName": "Ana", "emails": ["ana@ejemplo.test"] }')8  case "$codigo" in9    429|503) espera=$(grep -i '^retry-after:' cabeceras.txt | tr -dc '0-9'); sleep "${espera:-5}" ;;10    409) grep -q '"in_progress"' respuesta.json || break; sleep 2 ;;11    000) sleep 5 ;;12    *) break ;;13  esac14done