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

# Visuelle Anmerkungen zu Fotos hinzufügen

> Platzieren Sie Kommentare an exakten Positionen auf einem Foto mithilfe von x/y-Koordinaten, antworten Sie in Anmerkungs-Threads und lösen Sie Notizen auf, sobald das Feedback bearbeitet wurde.

Anmerkungen sind Kommentare, die an einer präzisen Position auf einem Foto platziert werden. Anstatt in einer allgemeinen Nachricht "die Haare links korrigieren" zu schreiben, klicken Sie auf die exakte Stelle im Bild und tippen dort Ihre Notiz ein. Sowohl Fotografen als auch Kunden (Prüfer) können Anmerkungen hinzufügen, in Thread-Kommentaren auf die Notizen des jeweils anderen antworten und Notizen als aufgelöst markieren, sobald das Feedback bearbeitet wurde.

## Eine Anmerkung hinzufügen

<Steps>
  <Step title="Anmerkungsmodus aufrufen">
    Öffnen Sie ein Foto und klicken Sie auf die Schaltfläche **Notiz hinzufügen** (oder drücken Sie `Strg+N` / `Cmd+N`). Der Cursor wird zu einem Fadenkreuz, um anzuzeigen, dass Sie sich im Anmerkungsmodus befinden.
  </Step>

  <Step title="Platzieren Sie Ihre Markierung">
    Klicken Sie an eine beliebige Stelle auf dem Foto, um dort eine Markierung zu setzen. Für rechteckige Flächenanmerkungen wechseln Sie in den Rechteckmodus und ziehen ein Kästchen über den Bereich, den Sie hervorheben möchten.
  </Step>

  <Step title="Geben Sie Ihren Kommentar ein">
    Neben Ihrer Markierung erscheint ein Texteingabefeld. Geben Sie Ihr Feedback ein und klicken Sie auf **Speichern** (oder drücken Sie die Eingabetaste), um die Anmerkung zu veröffentlichen.
  </Step>

  <Step title="Anmerkungsmodus verlassen">
    Klicken Sie auf **Fertig** oder drücken Sie erneut `Strg+N` / `Cmd+N`, um den Anmerkungsmodus zu verlassen. Ihre Notizen werden gespeichert und sind für alle sichtbar, die Zugriff auf das Foto haben.
  </Step>
</Steps>

<Info>
  Anmerkungen werden mithilfe von prozentualen x/y-Koordinaten relativ zum Foto platziert, sodass sie unabhängig von Bildschirmgröße oder Zoomstufe an der richtigen Position bleiben.
</Info>

## Wer kann Anmerkungen hinzufügen

<CardGroup cols={2}>
  <Card title="Fotografen (Eigentümer)" icon="camera">
    Eigentümer können Anmerkungen hinzufügen, ihre eigenen Notizen bearbeiten, Markierungen im Anmerkungsmodus per Drag-and-Drop verschieben und jede Anmerkung auf dem Foto löschen.
  </Card>

  <Card title="Kunden (Prüfer)" icon="user-check">
    Prüfer können Anmerkungen hinzufügen und auf bestehende Anmerkungs-Threads antworten. Sie können keine Notizen löschen, die von anderen Benutzern hinterlassen wurden.
  </Card>
</CardGroup>

<Note>
  Gast-Benutzer können Fotos und deren Anmerkungen ansehen, aber keine Notizen hinzufügen oder bearbeiten.
</Note>

## Anmerkungs-Threads

Jede Anmerkung unterstützt einen Antwort-Thread, sodass Gespräche über eine bestimmte Stelle an einem Ort organisiert bleiben.

* Klicken Sie auf eine beliebige Anmerkungsmarkierung, um das Thread-Panel zu öffnen.
* Geben Sie im Antwortfeld am unteren Ende des Threads einen Text ein und klicken Sie auf **Senden**, um eine Antwort zu veröffentlichen.
* Sie können Ihre eigenen Kommentare aus einem Thread löschen; Eigentümer können jeden Kommentar löschen.

## Anmerkungen auflösen

Sobald Sie ein Feedback bearbeitet haben, markieren Sie die Anmerkung als aufgelöst, um die Liste übersichtlich zu halten.

<Steps>
  <Step title="Eine einzelne Anmerkung auflösen">
    Öffnen Sie eine Anmerkung und klicken Sie auf **Auflösen**. Die Markierung wird grau und wechselt in die Filteransicht "Aufgelöst". Klicken Sie bei Bedarf auf **Als nicht aufgelöst markieren**, um sie erneut zu öffnen.
  </Step>

  <Step title="Alle offenen Anmerkungen auf einmal auflösen">
    Wenn Sie alles ausstehende Feedback bearbeitet haben, klicken Sie oben im Anmerkungs-Panel auf **Alle auflösen**. Damit werden alle offenen Anmerkungen auf dem Foto in einem Schritt als aufgelöst markiert.
  </Step>
</Steps>

Sie können die Anmerkungsliste nach **Alle**, **Offen** oder **Aufgelöst** filtern, um sich auf das zu konzentrieren, was noch Beachtung braucht.

<Tip>
  Lösen Sie Anmerkungen auf, während Sie überarbeitete Fotos hochladen. Eine saubere, aufgelöste Liste macht es einfach, auf einen Blick zu bestätigen, dass alles Feedback bearbeitet wurde, bevor Sie die nächste Prüfrunde anfordern.
</Tip>

## API

Sie können Anmerkungen programmatisch über die Shootbin-API verwalten. Alle Anfragen erfordern ein Bearer-Token und `Accept: application/json`.

### Eine Anmerkung hinzufügen

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

**Anfragebody:**

```json theme={null}
{
  "comment": "Please retouch the background near the top-left corner.",
  "x_position": 12.5,
  "y_position": 8.3
}
```

| Feld         | Typ    | Beschreibung                                                 |
| ------------ | ------ | ------------------------------------------------------------ |
| `comment`    | string | Der Anmerkungstext. Erforderlich.                            |
| `x_position` | float  | Horizontale Position als Prozentsatz (0-100) der Fotobreite. |
| `y_position` | float  | Vertikale Position als Prozentsatz (0-100) der Fotohöhe.     |

**Beispiel:**

```bash theme={null}
curl -X POST https://your-domain.tld/api/projects/PROJECT_ID/albums/ALBUM_ID/photos/PHOTO_ID/annotations \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"comment":"Soften the shadow on the left cheek.","x_position":42.5,"y_position":31.2}'
```

### Eine Anmerkung löschen

```bash theme={null}
DELETE /api/projects/{project}/albums/{album}/photos/{photo}/annotations/{annotation}
```

```bash theme={null}
curl -X DELETE https://your-domain.tld/api/projects/PROJECT_ID/albums/ALBUM_ID/photos/PHOTO_ID/annotations/ANNOTATION_ID \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
```

<Warning>
  Beim Löschen einer Anmerkung wird auch der gesamte Antwort-Thread entfernt. Diese Aktion kann nicht rückgängig gemacht werden.
</Warning>

## Verwandte Seiten

* [Prüfungsablauf](/de/guides/review-workflow), wie der übergreifende Proofing-Ablauf zwischen Fotograf und Kunde funktioniert
* [Fotos für die Lieferung freigeben, ablehnen und auswählen](/de/guides/approvals), einzelne Fotos als freigegeben oder abgelehnt markieren
