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

# Visuele annotaties toevoegen aan foto's

> Pin opmerkingen op exacte locaties op een foto met behulp van x/y-coördinaten, beantwoord in annotatiediscussies en los notities op zodra de feedback is verwerkt.

Annotaties zijn opmerkingen die op een precieze locatie op een foto worden vastgemaakt. In plaats van "haar links bijwerken" in een algemeen bericht te schrijven, klik je op de exacte plek op de afbeelding en typ je je notitie daar. Zowel fotografen als klanten (beoordelaars) kunnen annotaties toevoegen, op elkaars notities reageren in discussielijntjes en notities markeren als opgelost zodra de feedback is verwerkt.

## Een annotatie toevoegen

<Steps>
  <Step title="Schakel de annotatiemodus in">
    Open een foto en klik op de knop **Notitie toevoegen** (of druk op `Ctrl+N` / `Cmd+N`). De cursor verandert in een dradenkruis om aan te geven dat je in de annotatiemodus bent.
  </Step>

  <Step title="Plaats je marker">
    Klik ergens op de foto om op die positie een marker te plaatsen. Voor rechthoekige gebiedsannotaties schakel je over naar de rechthoekmodus en sleep je om een vak te tekenen over het gebied dat je wilt markeren.
  </Step>

  <Step title="Typ je opmerking">
    Naast je marker verschijnt een tekstinvoer. Typ je feedback en druk op **Opslaan** (of druk op Enter) om de annotatie te plaatsen.
  </Step>

  <Step title="Verlaat de annotatiemodus">
    Klik op **Klaar** of druk opnieuw op `Ctrl+N` / `Cmd+N` om de annotatiemodus te verlaten. Je notities worden opgeslagen en zijn zichtbaar voor iedereen met toegang tot de foto.
  </Step>
</Steps>

<Info>
  Annotaties worden vastgemaakt met behulp van procentuele x/y-coördinaten ten opzichte van de foto, zodat ze in de juiste positie blijven, ongeacht de schermgrootte of het zoomniveau.
</Info>

## Wie kan annoteren

<CardGroup cols={2}>
  <Card title="Fotografen (eigenaars)" icon="camera">
    Eigenaars kunnen annotaties toevoegen, hun eigen notities bewerken, markers verplaatsen door ze in de annotatiemodus te slepen en elke annotatie op de foto verwijderen.
  </Card>

  <Card title="Klanten (beoordelaars)" icon="user-check">
    Beoordelaars kunnen annotaties toevoegen en reageren op bestaande annotatiediscussies. Ze kunnen geen notities van andere gebruikers verwijderen.
  </Card>
</CardGroup>

<Note>
  Gastgebruikers kunnen foto's en hun annotaties bekijken, maar kunnen geen notities toevoegen of bewerken.
</Note>

## Annotatiediscussies

Elke annotatie ondersteunt een reactiediscussie, zodat gesprekken over een specifiek punt georganiseerd op één plek blijven.

* Klik op een annotatiemarker om het discussiepaneel te openen.
* Typ in het antwoordvak onderaan de discussie en druk op **Verzenden** om een reactie te plaatsen.
* Je kunt je eigen opmerkingen uit een discussie verwijderen; eigenaars kunnen elke opmerking verwijderen.

## Annotaties oplossen

Zodra je een stuk feedback hebt verwerkt, markeer je de annotatie als opgelost om de lijst overzichtelijk te houden.

<Steps>
  <Step title="Een enkele annotatie oplossen">
    Open een annotatie en klik op **Oplossen**. De marker wordt grijs en verplaatst naar de "Opgelost"-filterweergave. Klik op **Heropenen** om deze indien nodig opnieuw te openen.
  </Step>

  <Step title="Alle open annotaties in één keer oplossen">
    Wanneer je alle openstaande feedback hebt verwerkt, klik je op **Alles oplossen** bovenaan het annotatiepaneel. Hiermee markeer je in één actie elke openstaande annotatie op de foto als opgelost.
  </Step>
</Steps>

Je kunt de annotatielijst filteren op **Alles**, **Open** of **Opgelost** om je te concentreren op wat nog aandacht nodig heeft.

<Tip>
  Los annotaties op terwijl je herziene foto's uploadt. Een schone, opgeloste lijst maakt het in één oogopslag eenvoudig om te bevestigen dat alle feedback is verwerkt voordat je de volgende beoordelingsronde aanvraagt.
</Tip>

## API

Je kunt annotaties programmatisch beheren met behulp van de Shootbin API. Alle aanvragen vereisen een Bearer-token en `Accept: application/json`.

### Een annotatie toevoegen

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

**Aanvraaglichaam:**

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

| Veld         | Type   | Beschrijving                                                   |
| ------------ | ------ | -------------------------------------------------------------- |
| `comment`    | string | De annotatietekst. Verplicht.                                  |
| `x_position` | float  | Horizontale positie als percentage (0–100) van de fotobreedte. |
| `y_position` | float  | Verticale positie als percentage (0–100) van de fotohoogte.    |

**Voorbeeld:**

```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}'
```

### Een annotatie verwijderen

```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>
  Het verwijderen van een annotatie verwijdert ook de volledige reactiediscussie. Deze actie kan niet ongedaan worden gemaakt.
</Warning>

## Gerelateerde pagina's

* [Beoordelingsworkflow](/nl/guides/review-workflow), hoe de bredere proofingcyclus tussen fotograaf en klant werkt
* [Foto's goedkeuren, afkeuren en selecteren voor levering](/nl/guides/approvals), individuele foto's markeren als goedgekeurd of afgekeurd