> ## 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.
# Añadir anotaciones visuales a las fotos
> Fija comentarios en ubicaciones exactas de una foto con coordenadas x/y, responde en hilos de anotaciones y resuelve notas cuando se ha atendido el comentario.
Las anotaciones son comentarios fijados en una ubicación precisa de una foto. En lugar de escribir "arregla el cabello de la izquierda" en un mensaje general, haces clic en el punto exacto de la imagen y escribes tu nota allí. Tanto los fotógrafos como los clientes (revisores) pueden añadir anotaciones, responder a las notas de los demás en hilos de comentarios y marcar las notas como resueltas cuando se ha atendido el comentario.
## Añadir una anotación
Abre una foto y haz clic en el botón **Añadir nota** (o pulsa `Ctrl+N` / `Cmd+N`). El cursor cambia a un punto de mira para indicar que estás en modo de anotación.
Haz clic en cualquier punto de la foto para soltar un marcador en esa posición. Para anotaciones de área rectangular, cambia al modo rectángulo y arrastra para dibujar un recuadro sobre la zona que quieres resaltar.
Junto a tu marcador aparece un campo de texto. Escribe tu comentario y pulsa **Guardar** (o la tecla Enter) para publicar la anotación.
Haz clic en **Listo** o pulsa `Ctrl+N` / `Cmd+N` de nuevo para salir del modo de anotación. Tus notas se guardan y son visibles para todos los que tienen acceso a la foto.
Las anotaciones se fijan mediante coordenadas x/y en porcentaje relativas a la foto, por lo que se mantienen en la posición correcta sin importar el tamaño de la pantalla ni el nivel de zoom.
## Quién puede anotar
Los propietarios pueden añadir anotaciones, editar sus propias notas, mover los marcadores arrastrándolos en el modo de anotación y eliminar cualquier anotación de la foto.
Los revisores pueden añadir anotaciones y responder a los hilos de anotaciones existentes. No pueden eliminar notas dejadas por otros usuarios.
Los usuarios invitados pueden ver las fotos y sus anotaciones, pero no pueden añadir ni editar notas.
## Hilos de anotaciones
Cada anotación admite un hilo de respuestas, de modo que las conversaciones sobre un punto concreto se mantienen organizadas en un solo lugar.
* Haz clic en cualquier marcador de anotación para abrir el panel del hilo.
* Escribe en el campo de respuesta en la parte inferior del hilo y pulsa **Enviar** para publicar una respuesta.
* Puedes eliminar tus propios comentarios de un hilo; los propietarios pueden eliminar cualquier comentario.
## Resolver anotaciones
Cuando has atendido un comentario, marca la anotación como resuelta para mantener la lista ordenada.
Abre una anotación y haz clic en **Resolver**. El marcador se vuelve gris y pasa a la vista de filtro "Resueltas". Haz clic en **Deshacer resolución** para reabrirla si es necesario.
Cuando hayas atendido todos los comentarios pendientes, haz clic en **Resolver todo** en la parte superior del panel de anotaciones. Esto marca todas las anotaciones abiertas de la foto como resueltas en una sola acción.
Puedes filtrar la lista de anotaciones por **Todas**, **Abiertas** o **Resueltas** para centrarte en lo que aún necesita atención.
Resuelve las anotaciones a medida que subes fotos revisadas. Una lista limpia de resueltas facilita confirmar de un vistazo que se atendió todo el comentario antes de solicitar la siguiente ronda de revisión.
## API
Puedes gestionar las anotaciones mediante programación con la API de Shootbin. Todas las solicitudes requieren un token Bearer y `Accept: application/json`.
### Añadir una anotación
```bash theme={null}
POST /api/projects/{project}/albums/{album}/photos/{photo}/annotations
```
**Cuerpo de la solicitud:**
```json theme={null}
{
"comment": "Please retouch the background near the top-left corner.",
"x_position": 12.5,
"y_position": 8.3
}
```
| Campo | Tipo | Descripción |
| ------------ | ------ | ------------------------------------------------------------------ |
| `comment` | string | El texto de la anotación. Obligatorio. |
| `x_position` | float | Posición horizontal como porcentaje (0–100) del ancho de la foto. |
| `y_position` | float | Posición vertical como porcentaje (0–100) de la altura de la foto. |
**Ejemplo:**
```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}'
```
### Eliminar una anotación
```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"
```
Eliminar una anotación también elimina todo su hilo de respuestas. Esta acción no se puede deshacer.
## Páginas relacionadas
* [Flujo de revisión](/es/guides/review-workflow), cómo funciona el ciclo de pruebas entre fotógrafo y cliente
* [Aprobar, rechazar y seleccionar fotos para la entrega](/es/guides/approvals), marcar fotos individuales como aprobadas o rechazadas