Idempotencia
Envía `Idempotency-Key` en `POST /api/v1/media` para que los reintentos tras fallos de red no creen subidas duplicadas.
Los clientes de publicación y exportación reintentan ante pérdida de red, timeouts y respuestas ambiguas. POST /api/v1/media acepta:
Idempotency-Key: <unique-string>
Semántica
- Misma clave + mismo cuerpo de petición → misma respuesta
media_id(reintento seguro) - Misma clave + cuerpo distinto → conflicto 409
- Las claves tienen ámbito del principal autenticado y del espacio de trabajo
Recomendación para Lightroom
Usa una clave estable por intento de publicación, p. ej.:
lr-{catalogId}-{photoUuid}-{exportRevision}
Guarda el media_id devuelto en la foto publicada para que una republicación pueda elegir actualizar frente a una subida nueva cuando exista PATCH de media.