> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shootbin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Téléverser des révisions de photos et suivre l'historique

> Téléversez une nouvelle version d'une photo pour remplacer la version actuelle. La version précédente est archivée automatiquement afin que vous puissiez la comparer ou la restaurer plus tard.

Une révision est une nouvelle version d'une photo existante. Lorsqu'un client laisse des notes sur une photo et que vous effectuez des retouches en post-production, vous téléversez le fichier révisé comme une révision plutôt que comme un téléversement séparé. Shootbin archive automatiquement la version précédente et remplace la photo en ligne par le nouveau fichier, en conservant l'historique complet des versions afin que vous et votre client puissiez comparer les versions et restaurer les plus anciennes si nécessaire.

## Ce qui se passe lorsque vous téléversez une révision

* La photo actuellement en ligne est archivée comme entrée de révision.
* Le fichier téléversé devient la nouvelle version en ligne.
* Toutes les annotations (notes) qui se trouvaient sur la photo en ligne précédente sont retirées de la nouvelle photo actuelle.
* L'état d'approbation est réinitialisé, la photo revient à un état en attente et le client doit approuver à nouveau la version révisée.

<Info>
  La réinitialisation de l'approbation lors du téléversement est intentionnelle : une photo révisée nécessite une nouvelle validation du relecteur. Si le client avait déjà approuvé l'original, la révision relance le cycle de validation.
</Info>

## Téléverser une révision

<Steps>
  <Step title="Ouvrir la photo">
    Accédez à la photo que vous souhaitez réviser. Cliquez sur la vignette de la photo dans l'album pour ouvrir la vue de détail de la photo.
  </Step>

  <Step title="Trouver la section de téléversement de révision">
    Dans la vue de détail de la photo, localisez le panneau de révision sur le côté droit. Si aucune révision n'a encore été téléversée, vous verrez une option pour téléverser la première révision.
  </Step>

  <Step title="Sélectionner votre fichier révisé">
    Cliquez sur le champ de fichier dans le panneau de révision et sélectionnez l'image révisée sur votre ordinateur.
  </Step>

  <Step title="Soumettre la révision">
    Cliquez sur **Téléverser une révision**. Shootbin archive la version actuelle et la remplace par votre fichier téléversé.
  </Step>
</Steps>

<Danger>
  Parce que Shootbin gère tout votre flux, de la prise de vue à la livraison, il est important que vous téléversiez vos fichiers de révision dans la même qualité et la même taille que celles que vous livreriez au client. À la fin du flux, ce sont également les photos que votre client peut télécharger.
</Danger>

<Note>
  Seuls les propriétaires du projet peuvent téléverser des révisions. Les relecteurs et les invités ne peuvent pas téléverser de fichiers révisés.
</Note>

## Consulter l'historique des révisions

Une fois qu'au moins une révision a été téléversée, la vue de détail de la photo affiche une section **Historique des révisions** listant toutes les versions archivées. Chaque entrée affiche le numéro de la révision et l'horodatage du téléversement.

Cliquez sur n'importe quelle entrée de révision pour consulter cette version de la photo. Vous consultez une version archivée (non en ligne) pendant que vous parcourez l'historique des révisions, une bannière dans la vue de la photo l'indique.

## Restaurer une révision antérieure

Si vous devez revenir à une version précédente d'une photo, vous pouvez restaurer n'importe quelle révision archivée.

<Steps>
  <Step title="Ouvrir l'historique des révisions">
    Dans la vue de détail de la photo, faites défiler jusqu'à la section de l'historique des révisions et cliquez sur la révision que vous souhaitez restaurer.
  </Step>

  <Step title="Restaurer la révision">
    Cliquez sur **Restaurer cette version**. Shootbin fait de la révision sélectionnée la nouvelle photo en ligne et archive la version actuelle.
  </Step>
</Steps>

<Warning>
  La restauration d'une révision réinitialise l'état d'approbation, tout comme le téléversement d'une nouvelle révision. La photo devra être ré-approuvée par le client.
</Warning>

## Supprimer la révision la plus récente

Si la révision la plus récente a été téléversée par erreur, les propriétaires peuvent la supprimer depuis la vue de détail de la photo. Cela supprime la révision la plus récente et ramène la photo à la version en ligne précédente.

## API

Vous pouvez également téléverser des révisions par programmation à l'aide de l'API Shootbin.

```bash theme={null}
POST /api/projects/{project}/albums/{album}/photos/{photo}/revisions
```

Incluez le fichier révisé comme champ `revision` dans une requête `multipart/form-data` :

```bash theme={null}
curl -X POST https://your-domain/api/projects/PROJECT_ID/albums/ALBUM_ID/photos/PHOTO_ID/revisions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -F "revision=@/path/to/revised-photo.jpg"
```

Les mêmes règles s'appliquent via l'API : la photo en ligne précédente est archivée, les annotations sont effacées de la nouvelle photo actuelle et l'état d'approbation est réinitialisé.

<Tabs>
  <Tab title="Réponse en cas de succès">
    En cas de succès, l'API renvoie l'objet photo mis à jour avec le nouvel horodatage `revision_uploaded_at` et `approved_at` défini sur `null`.
  </Tab>

  <Tab title="Autorisations requises">
    Le jeton API doit avoir la permission `update` (ou `post:update`). L'utilisateur authentifié doit être le propriétaire du projet.
  </Tab>
</Tabs>