GET /api/cameras/:id/snapshot

Retorna o último frame capturado pela câmera como imagem JPEG. Inclui headers com as dimensões do frame.

Autenticação

Scope necessário: cameras:read

Inclua o header Authorization: Bearer <api-key> ou use cookie de sessão.

Requisição

GET /api/cameras/:id/snapshot

Headers

Header	Obrigatório	Descrição
`Authorization`	sim	`Bearer pk_...` (API key) ou cookie de sessão

Parâmetros de rota

Parâmetro	Tipo	Obrigatório	Descrição
`id`	string	sim	UUID da câmera

Exemplo

curl "https://api.placaflow.com.br/api/cameras/7012e192-5005-43b6-978c-7e304b3676a6/snapshot" \
  -H "Authorization: Bearer pk_a1b2c3d4e5f6g7h8i9j0..." \
  --output snapshot.jpg

Resposta 200

O corpo da resposta contém os bytes brutos da imagem JPEG.

Headers de resposta

Header	Tipo	Descrição
`Content-Type`	string	`image/jpeg`
`X-Frame-Width`	number	Largura do frame em pixels (quando disponível)
`X-Frame-Height`	number	Altura do frame em pixels (quando disponível)

Exemplo de headers

HTTP/1.1 200 OK
Content-Type: image/jpeg
X-Frame-Width: 1920
X-Frame-Height: 1080
Content-Length: 245760

Info

O snapshot retornado é o último frame capturado pelo agente de processamento. Se a câmera estiver desativada ou desconectada, o snapshot pode estar desatualizado ou indisponível.

Erros

Código	Descrição
401	Não autenticado ou API key inválida
403	API key não possui scope `cameras:read`
404	Câmera não encontrada ou snapshot indisponível
502	Agente de processamento indisponível