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

# Foto-Revisionen hochladen und den Verlauf verfolgen

> Laden Sie eine neue Version eines Fotos hoch, um die aktuelle zu ersetzen. Die vorherige Version wird automatisch archiviert, sodass Sie sie später vergleichen oder wiederherstellen können.

Eine Revision ist eine neue Version eines vorhandenen Fotos. Wenn ein Kunde Notizen auf einem Foto hinterlässt und Sie Änderungen in der Postproduktion vornehmen, laden Sie die überarbeitete Datei als Revision hoch, anstatt sie separat hochzuladen. Shootbin archiviert die vorherige Version automatisch und ersetzt das aktive Foto durch die neue Datei, wobei der vollständige Versionsverlauf erhalten bleibt, sodass Sie und Ihr Kunde Versionen vergleichen und bei Bedarf frühere Versionen wiederherstellen können.

## Was passiert, wenn Sie eine Revision hochladen

* Das aktuelle aktive Foto wird als Revisionseintrag archiviert.
* Die hochgeladene Datei wird zur neuen aktiven Version.
* Alle Anmerkungen (Notizen), die sich auf dem vorherigen aktiven Foto befanden, werden vom neuen aktuellen Foto entfernt.
* Der Freigabestatus wird zurückgesetzt, das Foto kehrt in einen ausstehenden Zustand zurück und der Kunde muss die überarbeitete Version erneut freigeben.

<Info>
  Das Zurücksetzen der Freigabe beim Hochladen ist beabsichtigt: Ein überarbeitetes Foto benötigt eine neue Freigabe vom Prüfer. Wenn der Kunde das Original bereits freigegeben hatte, startet die Revision den Prüfzyklus erneut.
</Info>

## Eine Revision hochladen

<Steps>
  <Step title="Öffnen Sie das Foto">
    Navigieren Sie zu dem Foto, das Sie überarbeiten möchten. Klicken Sie auf die Foto-Miniaturansicht im Album, um die Fotodetailansicht zu öffnen.
  </Step>

  <Step title="Finden Sie den Bereich für den Revisions-Upload">
    Suchen Sie in der Fotodetailansicht das Revisions-Panel auf der rechten Seite. Wenn noch keine Revision hochgeladen wurde, sehen Sie eine Option, um die erste Revision hochzuladen.
  </Step>

  <Step title="Wählen Sie Ihre überarbeitete Datei">
    Klicken Sie auf das Dateieingabefeld im Revisions-Panel und wählen Sie das überarbeitete Bild von Ihrem Computer aus.
  </Step>

  <Step title="Reichen Sie die Revision ein">
    Klicken Sie auf **Revision hochladen**. Shootbin archiviert die aktuelle Version und ersetzt sie durch Ihre hochgeladene Datei.
  </Step>
</Steps>

<Danger>
  Da Shootbin Ihren gesamten Ablauf von der Aufnahme bis zur Lieferung verwaltet, ist es wichtig, dass Sie Ihre Revisionsdateien in derselben Qualität und Größe hochladen, die Sie dem Kunden liefern würden. Am Ende des Ablaufs sind dies auch die Fotos, die Ihr Kunde herunterladen kann.
</Danger>

<Note>
  Nur Projekteigentümer können Revisionen hochladen. Prüfer und Gäste können keine überarbeiteten Dateien hochladen.
</Note>

## Revisionsverlauf anzeigen

Sobald mindestens eine Revision hochgeladen wurde, zeigt die Fotodetailansicht einen Abschnitt **Revisionsverlauf**, der alle archivierten Versionen auflistet. Jeder Eintrag zeigt die Revisionsnummer und den Upload-Zeitstempel.

Klicken Sie auf einen beliebigen Revisionseintrag, um diese Version des Fotos anzusehen. Während Sie den Revisionsverlauf durchsuchen, sehen Sie eine archivierte (nicht aktive) Version, ein Banner in der Fotoansicht weist darauf hin.

## Eine frühere Revision wiederherstellen

Wenn Sie zu einer früheren Version eines Fotos zurückkehren müssen, können Sie jede archivierte Revision wiederherstellen.

<Steps>
  <Step title="Öffnen Sie den Revisionsverlauf">
    Scrollen Sie in der Fotodetailansicht zum Abschnitt Revisionsverlauf und klicken Sie auf die Revision, die Sie wiederherstellen möchten.
  </Step>

  <Step title="Stellen Sie die Revision wieder her">
    Klicken Sie auf **Diese Version wiederherstellen**. Shootbin macht die ausgewählte Revision zum neuen aktiven Foto und archiviert die aktuelle Version.
  </Step>
</Steps>

<Warning>
  Das Wiederherstellen einer Revision setzt den Freigabestatus zurück, genau wie das Hochladen einer neuen Revision. Das Foto muss vom Kunden erneut freigegeben werden.
</Warning>

## Die neueste Revision entfernen

Wenn die neueste Revision versehentlich hochgeladen wurde, können Eigentümer sie aus der Fotodetailansicht löschen. Dadurch wird die neueste Revision entfernt und das Foto kehrt zur vorherigen aktiven Version zurück.

## API

Sie können Revisionen auch programmatisch über die Shootbin-API hochladen.

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

Fügen Sie die überarbeitete Datei als Feld `revision` in einer `multipart/form-data`-Anfrage ein:

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

Über die API gelten dieselben Regeln: Das vorherige aktive Foto wird archiviert, Anmerkungen werden vom neuen aktuellen Foto entfernt und der Freigabestatus wird zurückgesetzt.

<Tabs>
  <Tab title="Erfolgreiche Antwort">
    Bei Erfolg gibt die API das aktualisierte Fotoobjekt mit dem neuen Zeitstempel `revision_uploaded_at` und `approved_at` mit dem Wert `null` zurück.
  </Tab>

  <Tab title="Erforderliche Berechtigungen">
    Der API-Token muss über die Berechtigung `update` (oder `post:update`) verfügen. Der authentifizierte Benutzer muss der Projekteigentümer sein.
  </Tab>
</Tabs>