GET /api/recognitions/:id

Retorna um reconhecimento específico com URLs de imagem presignadas válidas por 1 hora. Este é o endpoint correto para acessar imagens de frames e recortes de placas.

Autenticação

Scope necessário: recognitions:read

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

Requisição

GET /api/recognitions/:id

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 do reconhecimento

Exemplo

curl "https://api.placaflow.com.br/api/recognitions/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer pk_a1b2c3d4e5f6g7h8i9j0..."

Resposta 200

{
  "recognition": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "userId": "c3a1e902-4f5b-4b8a-9c6d-1a2b3c4d5e6f",
    "cameraId": "7012e192-5005-43b6-978c-7e304b3676a6",
    "cameraName": "Entrada principal",
    "plate": "ABC1D23",
    "confidence": 0.96,
    "timestamp": "2026-03-22T14:30:00.000Z",
    "photoUrl": "https://placaflow.s3.sa-east-1.amazonaws.com/frames/7012e192/1711115400000-photo.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=...&X-Amz-Signature=abc123...",
    "cropUrl": "https://placaflow.s3.sa-east-1.amazonaws.com/frames/7012e192/1711115400000-crop.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=...&X-Amz-Signature=def456...",
    "plateCoordinates": {
      "x": 622,
      "y": 301,
      "width": 429,
      "height": 80
    }
  }
}

Info

As URLs presignadas em photoUrl e cropUrl expiram após 1 hora. Se precisar acessar as imagens novamente, faça uma nova requisição ao endpoint.

Campos da resposta

Campo	Tipo	Descrição
`id`	string	UUID único do reconhecimento
`userId`	string	UUID do proprietário
`cameraId`	string	UUID da câmera de origem
`cameraName`	string	Nome da câmera
`plate`	string	Texto da placa (uppercase)
`confidence`	number	Confiança do reconhecimento (0-1)
`timestamp`	string	Data/hora ISO 8601
`photoUrl`	string?	URL presignada do frame completo (expira em 1h)
`cropUrl`	string?	URL presignada do recorte da placa (expira em 1h)
`plateCoordinates`	object?	Bounding box: `{x, y, width, height}` em pixels

Erros

Código	Descrição
401	Não autenticado ou API key inválida
403	API key não possui scope `recognitions:read`
404	Reconhecimento não encontrado