Docs/Captures

Captures

Capturez des images haute qualité d'une session en direct et récupérez-les plus tard.

Envoyer une capture

POST/agent-view/snapshots

Depuis un lecteur agent personnalisé, envoyez une image capturée à l'aide du jeton d'agent — le fragment après # dans agentViewUrl. L'envoi est authentifié par le jeton lui-même, pas par une connexion au tableau de bord.

Champ	Description
`code`	Le code d'invitation de 6 à 10 caractères — le segment de chemin d'`agentViewUrl`, avant le fragment `#`.
`token`	Le jeton de visionnage agent — le fragment d'URL après `#` dans `agentViewUrl`. Rejeté si le lien n'a pas été émis avec la capture d'écran activée.
`image`	L'image capturée sous forme d'URL de données 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"
}

Limité en débit

Limité à 30 requêtes par minute et par IP.

Trois modes d'authentification

Lister et récupérer les captures acceptent un JWT de tableau de bord, une clé API d'équipe, ou un jeton OAuth avec la portée sessions:read. Les deux nécessitent aussi la fonctionnalité de forfait Historique des captures et export du compte — sans elle, vous obtenez une erreur 402.

Lister les captures

GET/sessions/:id/snapshots

Renvoie les captures d'écran de la session, les plus récentes en premier. Chaque entrée inclut les dimensions en pixels lues dans l'en-tête PNG et une url pour récupérer les octets. Nécessite la permission view_snapshots sur un JWT de tableau de bord.

# 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"
  }
]

Récupérer les octets d'une capture

GET/snapshots/:id

Diffuse les octets PNG bruts d'une capture (content-type: image/png). Nécessite la même permission view_snapshots que pour lister les captures.

Ajoutez ?format=base64 pour recevoir du JSON à la place : {id, contentType, width, height, capturedAt, data}, où data est le PNG encodé en base64. Toute autre valeur de format renvoie 400. Destiné aux appelants qui ne peuvent pas recevoir de réponses binaires, comme les modèles de requête Freshworks.

Requêtes d'image authentifiées

Ce point de terminaison nécessite un en-tête Authorization (JWT de tableau de bord, clé API, ou jeton OAuth), donc une simple balise img ne peut pas le charger — récupérez les octets avec cet en-tête et affichez-les depuis une URL blob à la place.

Sessions Erreurs