Idempotencia

Obtener una clave de API

Un error de red puede dejarte sin saber si se creó una publicación. Envía una cabecera Idempotency-Key con POST /v1/posts y POST /v1/media, y reintenta con la misma clave: Sofia responde lo mismo que la primera vez y no crea nada por duplicado.

bash

curl -X POST https://api.sofia-post.com/api/v1/posts \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d @post.json

Usa una clave aleatoria nueva (un UUID) para cada publicación nueva, y la misma clave para cada reintento de esa publicación.
La misma clave con un cuerpo distinto responde 422 idempotency_key_reused.
Mientras la primera petición sigue en curso, la misma clave responde 409 idempotency_in_progress: reintenta un momento después.