Processador OCR de Placas

Envie imagens de veículos para rodar o PaddleOCR localizado e validações de formatos de placas

Análise de Imagem

Nenhum Arquivo Selecionado

Arraste e Solte Imagens Aqui

Suporta formatos de imagem comuns de até 10MB (Selecione múltiplos arquivos)

Resultados OCR

Aguardando Processamento

Envie uma imagem de veículo e clique em "Processar OCR" para ver os dados da placa

Dashboard do Cliente

Junho 2026
API Key:
mt_live_xxxxxxxxxxxxxxxx
Requests hoje: 0
Requests mês: 0
Taxa de sucesso: 0.0%
Tempo médio: 0.0s

Chaves de API

Nome Prefixo Status Último Uso Ações
Carregando chaves de API...

Requisições Recentes

Data/Hora Endpoint Status Processamento
Nenhuma requisição registrada.

Privacidade e Direitos LGPD

Em conformidade com a Lei Geral de Proteção de Dados (LGPD - Lei nº 13.709/18), garantimos a você o controle total sobre seus dados pessoais. Caso decida encerrar suas atividades em nossa plataforma, você pode exercer seu Direito ao Esquecimento (Eliminação) utilizando o botão abaixo.

Atenção: Esta ação é definitiva e irreversível!

Ao confirmar, seu nome, e-mail e credenciais de acesso serão anonimizados permanentemente no banco de dados. Suas chaves de API atuais serão revogadas e você perderá o acesso a esta conta imediatamente.

Visão Geral Administrativa

Mês Atual
Clientes ativos: 0
Requests mês: 0
Tempo médio: 0.0s
Sucessos: 0
Falhas: 0
Chaves ativas: 0

Controle de Clientes

Cliente / Empresa E-mail Status Requisições (Mês) Latência Média Sucesso / Falha Chaves Usuários Última Req. Data de Cadastro Ações
Carregando clientes...

Todas as Chaves de API

Cliente Nome Prefixo Status Criada em Último uso
Carregando chaves...

Usuários do Sistema

Nome E-mail Perfil Cliente Criado em
Carregando usuários...

Feedbacks de Correção OCR

Data Arquivo Lido Correto Caractere Detalhes
Nenhum feedback de correção enviado.

Logs de Requisições Globais

Data/Hora Cliente Chave Endpoint Status Duração
Nenhum log de requisição disponível.

Auditoria Administrativa

Data/Hora Operador Ação IP Detalhes
Nenhum evento de auditoria disponível.

Documentação da API

FastAPI OCR

URL Base

http://localhost:8000

Autenticação

Todos os endpoints protegidos requerem o cabeçalho de chave de API interna.

X-Internal-API-Key: default_dev_key

Verificação de Saúde (Health)

GET /health 
curl http://localhost:8000/health
{
  "status": "healthy",
  "ocr_engine": "PaddleOCR V2"
}

Ler Placa

POST /api/plates/read

Envie um arquivo de imagem multipart. A API aceita formatos comuns de imagem incluindo JPEG, PNG, WEBP, AVIF, HEIC/HEIF, BMP, TIFF, GIF, JP2/J2K, PPM, PGM, PBM e uploads genéricos de imagens com extensão válida.

curl -X POST http://localhost:8000/api/plates/read \
  -H "X-Internal-API-Key: default_dev_key" \
  -F "file=@vehicle.jpg"
{
  "plate": "ABC1D23",
  "normalized_plate": "ABC1D23",
  "confidence": 0.9914,
  "needs_review": false,
  "candidates": [
    {
      "text": "ABC1D23",
      "confidence": 0.9914,
      "format": "BRAZIL_MERCOSUL"
    }
  ],
  "detected_plate_box": {
    "x": 437,
    "y": 595,
    "width": 200,
    "height": 48
  },
  "processing_time_ms": 3934,
  "warnings": [],
  "plate_detected": true,
  "raw_ocr_text": "ABC1D23",
  "normalized_candidates": ["ABC1D23"],
  "failure_stage": null,
  "debug_id": "req_..."
}

Feedback

POST /api/feedback/submit 
curl -X POST http://localhost:8000/api/feedback/submit \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "vehicle.jpg",
    "detected_plate": "ABC1D28",
    "corrected_plate": "ABC1D23",
    "wrong_char_index": 7,
    "wrong_char_value": "8",
    "correct_char_value": "3"
  }'

Clientes

POST /api/admin/clients

Cria uma conta de cliente. Os endpoints administrativos usam a chave interna do servidor.

curl -X POST http://localhost:8000/api/admin/clients \
  -H "X-Internal-API-Key: default_dev_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Cliente X",
    "email": "cliente@example.com",
    "status": "active"
  }'
POST /api/admin/clients/{client_id}/api-keys

Gera uma chave de API para o cliente. A chave bruta é retornada apenas uma vez. O banco de dados armazena apenas key_hash e key_prefix.

curl -X POST http://localhost:8000/api/admin/clients/{client_id}/api-keys \
  -H "X-Internal-API-Key: default_dev_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"default"}'

Resumo de Uso

GET /api/admin/clients/{client_id}/usage?month=YYYY-MM 
curl "http://localhost:8000/api/admin/clients/{client_id}/usage?month=2026-06" \
  -H "X-Internal-API-Key: default_dev_key"
{
  "client_id": "client-id",
  "month": "2026-06",
  "requests": 352,
  "average_seconds": 4.8,
  "success": 341,
  "failures": 11
}

Códigos de Status

  • 200 requisição processada, mesmo quando nenhuma placa é detectada.
  • 400 o arquivo enviado claramente não é uma imagem.
  • 401 chave de API ausente ou inválida.
  • 413 o arquivo excede o limite de tamanho configurado.
  • 500 falha inesperada no processamento OCR.