Idempotence
Envoyez `Idempotency-Key` sur `POST /api/v1/media` pour que les nouvelles tentatives après panne réseau ne créent pas de téléversements en double.
Les clients de publication et d'export réessayent en cas de perte réseau, timeouts et réponses ambiguës. POST /api/v1/media accepte :
Idempotency-Key: <unique-string>
Sémantique
- Même clé + même corps de requête → même réponse
media_id(nouvelle tentative sûre) - Même clé + corps différent → conflit 409
- Les clés sont limitées au principal authentifié et à l'espace de travail
Recommandation Lightroom
Utilisez une clé stable par tentative de publication, p. ex. :
lr-{catalogId}-{photoUuid}-{exportRevision}
Stockez le media_id renvoyé sur la photo publiée pour qu'une republication puisse choisir mise à jour vs nouveau téléversement lorsque PATCH media existe.