> ## 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.

# Fotorevisies uploaden en geschiedenis volgen

> Upload een nieuwe versie van een foto om de huidige te vervangen. De vorige versie wordt automatisch gearchiveerd, zodat je deze later kunt vergelijken of herstellen.

Een revisie is een nieuwe versie van een bestaande foto. Wanneer een klant notities achterlaat op een foto en je in postproductie aanpassingen maakt, upload je het herziene bestand als revisie in plaats van als aparte upload. Shootbin archiveert automatisch de vorige versie en vervangt de live foto door het nieuwe bestand, terwijl de volledige versiegeschiedenis intact blijft, zodat jij en je klant versies kunnen vergelijken en eerdere kunnen herstellen indien nodig.

## Wat gebeurt er wanneer je een revisie uploadt

* De huidige live foto wordt gearchiveerd als revisie-item.
* Het geüploade bestand wordt de nieuwe live versie.
* Eventuele annotaties (notities) die op de vorige live foto stonden, worden verwijderd uit de nieuwe huidige foto.
* De goedkeuringsstatus wordt gereset, de foto keert terug naar de status "in behandeling" en de klant moet de herziene versie opnieuw goedkeuren.

<Info>
  Het resetten van de goedkeuring bij upload is bewust: een herziene foto heeft een nieuwe fiat van de beoordelaar nodig. Als de klant het origineel al had goedgekeurd, start de revisie de beoordelingscyclus opnieuw.
</Info>

## Een revisie uploaden

<Steps>
  <Step title="Open de foto">
    Navigeer naar de foto die je wilt herzien. Klik op de fotominiatuur in het album om de fotodetailweergave te openen.
  </Step>

  <Step title="Vind de upload-sectie voor revisies">
    In de fotodetailweergave bevindt zich het revisiepaneel aan de rechterkant. Als er nog geen revisie is geüpload, zie je een optie om de eerste revisie te uploaden.
  </Step>

  <Step title="Selecteer je herziene bestand">
    Klik op de bestandsinvoer in het revisiepaneel en selecteer de herziene afbeelding van je computer.
  </Step>

  <Step title="Stuur de revisie in">
    Klik op **Revisie uploaden**. Shootbin archiveert de huidige versie en vervangt deze door je geüploade bestand.
  </Step>
</Steps>

<Danger>
  Omdat Shootbin je hele flow beheert, van shoot tot oplevering, is het belangrijk dat je jouw revisiebestanden uploadt in dezelfde kwaliteit en grootte als waarin je ze aan de klant zou leveren. Aan het einde van de flow zijn dit ook de foto's die je klant kan downloaden.
</Danger>

<Note>
  Alleen projecteigenaren kunnen revisies uploaden. Beoordelaars en gasten kunnen geen herziene bestanden uploaden.
</Note>

## Revisiegeschiedenis bekijken

Zodra er ten minste één revisie is geüpload, toont de fotodetailweergave een sectie **Revisiegeschiedenis** met een lijst van alle gearchiveerde versies. Elk item toont het revisienummer en de uploadtijd.

Klik op een revisie-item om die versie van de foto te bekijken. Je bekijkt een gearchiveerde (niet-live) versie tijdens het doorbladeren van de revisiegeschiedenis, een banner in de fotoweergave geeft dit aan.

## Een eerdere revisie herstellen

Als je terug moet rollen naar een eerdere versie van een foto, kun je elke gearchiveerde revisie herstellen.

<Steps>
  <Step title="Open de revisiegeschiedenis">
    Scrol in de fotodetailweergave naar de revisiegeschiedenissectie en klik op de revisie die je wilt herstellen.
  </Step>

  <Step title="Herstel de revisie">
    Klik op **Deze versie herstellen**. Shootbin maakt de geselecteerde revisie de nieuwe live foto en archiveert de huidige versie.
  </Step>
</Steps>

<Warning>
  Het herstellen van een revisie reset de goedkeuringsstatus, net als het uploaden van een nieuwe revisie. De foto moet opnieuw worden goedgekeurd door de klant.
</Warning>

## De laatste revisie verwijderen

Als de meest recente revisie per ongeluk is geüpload, kunnen eigenaars deze verwijderen vanuit de fotodetailweergave. Dit verwijdert de laatste revisie en zet de foto terug naar de vorige live versie.

## API

Je kunt revisies ook programmatisch uploaden via de Shootbin API.

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

Voeg het herziene bestand toe als een `revision`-veld in een `multipart/form-data`-aanvraag:

```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"
```

Dezelfde regels gelden via de API: de vorige live foto wordt gearchiveerd, annotaties worden gewist van de nieuwe huidige foto en de goedkeuringsstatus wordt gereset.

<Tabs>
  <Tab title="Succesrespons">
    Bij succes geeft de API het bijgewerkte foto-object terug met de nieuwe `revision_uploaded_at`-tijdstempel en `approved_at` ingesteld op `null`.
  </Tab>

  <Tab title="Vereiste permissies">
    Het API-token moet `update` (of `post:update`) permissie hebben. De geauthenticeerde gebruiker moet de projecteigenaar zijn.
  </Tab>
</Tabs>