> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/ocr.md).

# OCR Service

**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](/docs.facephi-pt-br/sdks/backend-sdk/ocr/technical_documentation/technical_specifications.md).

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.
* [Documentação online](https://doc-ocr-service.facephi.dev/).

## Diagrama de fluxo

![ocr-service fluxograma: verificar licença, executar ocr, executar interpretador](/files/ad64eb08e9c8731143ca3d6008bcdf17ad6edb22)