Docs/Capturas

Capturas

Captura fotogramas de alta calidad de una sesión en vivo y recupéralos más tarde.

Subir una captura

POST/agent-view/snapshots

Desde un visor de agente personalizado, sube un fotograma capturado usando el token de agente — el fragmento después de # en agentViewUrl. La subida se autentica con el propio token, no con una sesión del panel.

Campo	Descripción
`code`	El código de invitación de 6 a 10 caracteres — el segmento de ruta de `agentViewUrl`, antes del fragmento `#`.
`token`	El token de visualización de agente — el fragmento de la URL después de `#` en `agentViewUrl`. Se rechaza si el enlace no se emitió con la captura habilitada.
`image`	El fotograma capturado como una URL de datos PNG (`data:image/png;base64,…`).

curl -X POST https://api.seeitlive.io/v1/agent-view/snapshots \
  -H "Content-Type: application/json" \
  -d '{ "code": "xyz789", "token": "<agent token>", "image": "data:image/png;base64,iVBORw0K..." }'

json

{
  "id": "3f9a2b71-8c4d-4e2a-9b1f-1234567890ab"
}

Limitado en frecuencia

Limitado a 30 solicitudes por minuto por IP.

Tres formas de autenticarse

Listar y obtener capturas aceptan un JWT del panel, una clave de API de equipo, o un token OAuth con el ámbito sessions:read. Ambos requieren además la función de plan Historial de capturas y exportación de la cuenta — sin ella obtienes un 402.

Listar capturas

GET/sessions/:id/snapshots

Devuelve las capturas de la sesión, las más recientes primero. Cada entrada incluye las dimensiones en píxeles leídas del encabezado PNG y una url para obtener los bytes. Requiere el permiso view_snapshots en un JWT del panel.

# List a session's snapshots, then download one:
curl https://api.seeitlive.io/v1/sessions/$SESSION_ID/snapshots \
  -H "Authorization: Bearer $SEEITLIVE_KEY"

curl https://api.seeitlive.io/v1/snapshots/$SNAPSHOT_ID \
  -H "Authorization: Bearer $SEEITLIVE_KEY" \
  -o snapshot.png

json

[
  {
    "id": "3f9a2b71-8c4d-4e2a-9b1f-1234567890ab",
    "width": 1280,
    "height": 720,
    "capturedAt": "2026-07-07T09:15:12.000Z",
    "url": "/api/v1/snapshots/3f9a2b71-8c4d-4e2a-9b1f-1234567890ab"
  }
]

Obtener los bytes de una captura

GET/snapshots/:id

Transmite los bytes PNG sin procesar de una sola captura (content-type: image/png). Requiere el mismo permiso view_snapshots que para listar capturas.

Añade ?format=base64 para recibir JSON en su lugar: {id, contentType, width, height, capturedAt, data}, donde data es el PNG codificado en base64. Cualquier otro valor de format devuelve 400. Pensado para clientes que no pueden recibir respuestas binarias, como las plantillas de solicitud de Freshworks.

Solicitudes de imagen autenticadas

Este endpoint requiere un encabezado Authorization (JWT del panel, clave de API o token OAuth), por lo que una simple etiqueta img no puede cargarlo — obtén los bytes con ese encabezado y renderízalos desde una URL blob en su lugar.

Sesiones Errores