Ajouter des annotations visuelles aux photos

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

Entrez en mode 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.

Placez votre marqueur

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.

Saisissez votre commentaire

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.

Quittez le mode 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

Photographes (propriétaires)

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.

Clients (relecteurs)

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.

Résolvez une seule annotation

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.

Résolvez toutes les annotations ouvertes d'un coup

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

POST /api/projects/{project}/albums/{album}/photos/{photo}/annotations

Corps de la requête :

{
  "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 :

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

DELETE /api/projects/{project}/albums/{album}/photos/{photo}/annotations/{annotation}

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, comment fonctionne la boucle d’épreuvage entre le photographe et le client
Approuver, rejeter et sélectionner des photos pour la livraison, marquer des photos individuelles comme approuvées ou rejetées

​Ajouter une annotation

​Qui peut annoter

Photographes (propriétaires)

Clients (relecteurs)

​Fils d’annotation

​Résoudre les annotations

​API

​Ajouter une annotation

​Supprimer une annotation

​Pages connexes

Ajouter une annotation

Qui peut annoter

Fils d’annotation

Résoudre les annotations

API

Ajouter une annotation

Supprimer une annotation

Pages connexes