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

# Sube revisiones de fotos y haz seguimiento del historial

> Sube una versión nueva de una foto para sustituir a la actual. La versión anterior se archiva automáticamente para que puedas compararla o restaurarla más adelante.

Una revisión es una versión nueva de una foto existente. Cuando un cliente deja notas en una foto y haces ediciones en postproducción, subes el archivo revisado como una revisión en lugar de una subida aparte. Shootbin archiva automáticamente la versión anterior y sustituye la foto activa por el archivo nuevo, manteniendo intacto el historial completo de versiones para que tú y tu cliente podáis comparar versiones y restaurar las anteriores si es necesario.

## Qué ocurre cuando subes una revisión

* La foto activa actual se archiva como una entrada de revisión.
* El archivo subido se convierte en la nueva versión activa.
* Las anotaciones (notas) que había en la foto activa anterior se eliminan de la nueva foto actual.
* El estado de aprobación se restablece, la foto vuelve a un estado pendiente y el cliente debe volver a aprobar la versión revisada.

<Info>
  Restablecer la aprobación al subir es intencional: una foto revisada necesita una nueva aprobación por parte del revisor. Si el cliente ya había aprobado el original, la revisión inicia el ciclo de revisión de nuevo.
</Info>

## Subir una revisión

<Steps>
  <Step title="Abre la foto">
    Ve a la foto que quieres revisar. Haz clic en la miniatura de la foto en el álbum para abrir la vista de detalle de la foto.
  </Step>

  <Step title="Busca la sección de subida de revisiones">
    En la vista de detalle de la foto, localiza el panel de revisiones en el lado derecho. Si aún no se ha subido ninguna revisión, verás una opción para subir la primera revisión.
  </Step>

  <Step title="Selecciona tu archivo revisado">
    Haz clic en el selector de archivos del panel de revisiones y selecciona la imagen revisada de tu ordenador.
  </Step>

  <Step title="Envía la revisión">
    Haz clic en **Subir revisión**. Shootbin archiva la versión actual y la sustituye por tu archivo subido.
  </Step>
</Steps>

<Danger>
  Como Shootbin gestiona todo tu flujo, desde la sesión hasta la entrega, es importante que subas tus archivos de revisión con la misma calidad y tamaño con los que los entregarías al cliente. Al final del flujo, también son las fotos que tu cliente puede descargar.
</Danger>

<Note>
  Solo los propietarios del proyecto pueden subir revisiones. Los revisores y los invitados no pueden subir archivos revisados.
</Note>

## Ver el historial de revisiones

Una vez que se ha subido al menos una revisión, la vista de detalle de la foto muestra una sección de **Historial de revisiones** que enumera todas las versiones archivadas. Cada entrada muestra el número de revisión y la marca de tiempo de subida.

Haz clic en cualquier entrada de revisión para ver esa versión de la foto. Mientras navegas por el historial de revisiones estás viendo una versión archivada (no activa), y un banner en la vista de la foto lo indica.

## Restaurar una revisión anterior

Si necesitas volver a una versión anterior de una foto, puedes restaurar cualquier revisión archivada.

<Steps>
  <Step title="Abre el historial de revisiones">
    En la vista de detalle de la foto, desplázate hasta la sección del historial de revisiones y haz clic en la revisión que quieras restaurar.
  </Step>

  <Step title="Restaura la revisión">
    Haz clic en **Restaurar esta versión**. Shootbin convierte la revisión seleccionada en la nueva foto activa y archiva la versión actual.
  </Step>
</Steps>

<Warning>
  Restaurar una revisión restablece el estado de aprobación, igual que al subir una revisión nueva. El cliente deberá volver a aprobar la foto.
</Warning>

## Eliminar la última revisión

Si la revisión más reciente se subió por error, los propietarios pueden eliminarla desde la vista de detalle de la foto. Esto elimina la última revisión y revierte la foto a la versión activa anterior.

## API

También puedes subir revisiones mediante programación usando la API de Shootbin.

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

Incluye el archivo revisado como un campo `revision` en una solicitud `multipart/form-data`:

```bash theme={null}
curl -X POST https://your-domain/api/projects/PROJECT_ID/albums/ALBUM_ID/photos/PHOTO_ID/revisions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -F "revision=@/path/to/revised-photo.jpg"
```

Las mismas reglas se aplican a través de la API: la foto activa anterior se archiva, las anotaciones se eliminan de la nueva foto actual y el estado de aprobación se restablece.

<Tabs>
  <Tab title="Respuesta correcta">
    En caso de éxito, la API devuelve el objeto de la foto actualizado con la nueva marca de tiempo `revision_uploaded_at` y `approved_at` establecido en `null`.
  </Tab>

  <Tab title="Permisos necesarios">
    El token de API debe tener el permiso `update` (o `post:update`). El usuario autenticado debe ser el propietario del proyecto.
  </Tab>
</Tabs>