For the complete documentation index, see llms.txt. This page is also available as Markdown.

Serviço OCR

Serviço OCR da Facephi é um serviço REST API escrito em C++ moderno que utiliza Facephi OCR SDK como uma poderosa ferramenta que ajuda a ler e verificar documentos de identidade e faturas oferecidos pela tecnologia da Facephi.

O serviço oferece os endpoints /process e /process_multi, por meio dos quais é possível enviar documentos e obter informações deles.

É possível habilitar opcionalmente a autenticação JWT ao iniciar o serviço a partir de config.json ou por meio das variáveis de ambiente FACEPHI_OCR_REST_AUTH_*. Quando o JWT está habilitado, GET /api/v1/version e GET /api/v1/health continuam públicos, enquanto os endpoints protegidos exigem um JWT válido. As configurações de inicialização do JWT nunca são expostas por meio de GET /api/v1/config nem podem ser modificadas por meio de POST /api/v1/config.

Mais informações podem ser encontradas em Especificações técnicas.

Formatos de imagem suportados para documentos de identidade:

  • JPG

  • PNG

  • BMP

  • HDR

Formato de arquivo suportado para faturas:

  • PDF

A distribuição principal contém os seguintes recursos:

  • Contêiner Docker. O contêiner está disponível no repositório Docker da Facephi e é baseado no Ubuntu 24.04. O contêiner inclui o serviço e todas as dependências necessárias para executá-lo.

Diagrama de fluxo

ocr-service fluxograma: verificar licença, executar ocr, executar interpretador

Atualizado