> ## 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. # Ajouter des annotations visuelles aux photos > Épinglez des commentaires sur des emplacements précis d'une photo à l'aide de coordonnées x/y, répondez dans les fils d'annotation et résolvez les notes une fois les retours traités. Les annotations sont des commentaires épinglés à un emplacement précis sur une photo. Au lieu d'écrire « corrigez les cheveux à gauche » dans un message général, vous cliquez sur l'endroit exact de l'image et saisissez votre note à cet endroit. Les photographes comme les clients (relecteurs) peuvent ajouter des annotations, répondre aux notes des uns et des autres dans des fils de commentaires, et marquer les notes comme résolues une fois les retours traités. ## Ajouter une annotation Ouvrez une photo et cliquez sur le bouton **Ajouter une note** (ou appuyez sur `Ctrl+N` / `Cmd+N`). Le curseur se transforme en réticule pour indiquer que vous êtes en mode annotation. Cliquez n'importe où sur la photo pour déposer un marqueur à cette position. Pour les annotations de zone rectangulaire, passez en mode rectangle et faites glisser pour dessiner un cadre sur la zone que vous souhaitez mettre en évidence. Un champ de texte apparaît à côté de votre marqueur. Saisissez votre retour et appuyez sur **Enregistrer** (ou sur Entrée) pour publier l'annotation. Cliquez sur **Terminé** ou appuyez à nouveau sur `Ctrl+N` / `Cmd+N` pour quitter le mode annotation. Vos notes sont enregistrées et visibles par toute personne ayant accès à la photo. Les annotations sont épinglées à l'aide de coordonnées x/y exprimées en pourcentage par rapport à la photo, elles restent donc à la bonne position quelle que soit la taille de l'écran ou le niveau de zoom. ## Qui peut annoter Les propriétaires peuvent ajouter des annotations, modifier leurs propres notes, déplacer les marqueurs en les faisant glisser en mode annotation et supprimer toute annotation sur la photo. Les relecteurs peuvent ajouter des annotations et répondre aux fils d'annotation existants. Ils ne peuvent pas supprimer les notes laissées par d'autres utilisateurs. Les invités peuvent consulter les photos et leurs annotations, mais ne peuvent ni ajouter ni modifier de notes. ## Fils d'annotation Chaque annotation prend en charge un fil de réponses, afin que les conversations sur un point précis restent organisées au même endroit. * Cliquez sur n'importe quel marqueur d'annotation pour ouvrir le panneau du fil. * Saisissez votre réponse dans la zone de réponse en bas du fil et appuyez sur **Envoyer** pour publier une réponse. * Vous pouvez supprimer vos propres commentaires d'un fil ; les propriétaires peuvent supprimer n'importe quel commentaire. ## Résoudre les annotations Une fois que vous avez traité un retour, marquez l'annotation comme résolue pour garder la liste ordonnée. Ouvrez une annotation et cliquez sur **Résoudre**. Le marqueur devient gris et passe dans la vue du filtre « Résolues ». Cliquez sur **Rouvrir** pour la rouvrir si nécessaire. Lorsque vous avez traité tous les retours en attente, cliquez sur **Tout résoudre** en haut du panneau des annotations. Cela marque toutes les annotations ouvertes de la photo comme résolues en une seule action. Vous pouvez filtrer la liste des annotations par **Toutes**, **Ouvertes** ou **Résolues** pour vous concentrer sur ce qui nécessite encore votre attention. Résolvez les annotations au fur et à mesure que vous téléversez des photos révisées. Une liste résolue et propre permet de confirmer d'un coup d'œil que tous les retours ont été traités avant de demander le prochain tour de validation. ## API Vous pouvez gérer les annotations par programmation à l'aide de l'API Shootbin. Toutes les requêtes nécessitent un jeton Bearer et `Accept: application/json`. ### Ajouter une annotation ```bash theme={null} POST /api/projects/{project}/albums/{album}/photos/{photo}/annotations ``` **Corps de la requête :** ```json theme={null} { "comment": "Please retouch the background near the top-left corner.", "x_position": 12.5, "y_position": 8.3 } ``` | Champ | Type | Description | | ------------ | ------ | ---------------------------------------------------------------------- | | `comment` | string | Le texte de l'annotation. Requis. | | `x_position` | float | Position horizontale en pourcentage (0-100) de la largeur de la photo. | | `y_position` | float | Position verticale en pourcentage (0-100) de la hauteur de la photo. | **Exemple :** ```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}' ``` ### Supprimer une annotation ```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" ``` Supprimer une annotation supprime également tout son fil de réponses. Cette action est irréversible. ## Pages connexes * [Flux de validation](/fr/guides/review-workflow), comment fonctionne la boucle d'épreuvage entre le photographe et le client * [Approuver, rejeter et sélectionner des photos pour la livraison](/fr/guides/approvals), marquer des photos individuelles comme approuvées ou rejetées