> 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/ine.md).

# INE Service

**Facephi INE Service** é um serviço de API REST em C++ que permite realizar Verificação de Identidade por meio de Reconhecimento Facial. O serviço é baseado no SDK SelphID, tecnologia desenvolvida por FacePhi. Implementa a especificação de Mexipay-INE (Instituto Nacional Eleitoral) do México.

O serviço expõe os seguintes endpoints:

* `POST /api/v1/facial/authentication`
* `GET /api/v1/health`
* `GET /api/v1/version`

Os formatos de imagem suportados são:

* INE (0)
* JPEG (1)
* TEMPLATE RAW (2)
* BEST IMAGE TOKEN (3)

A distribuição principal do serviço é um contêiner Docker baseado em Ubuntu 26.04.

### Autenticação JWT

A autenticação JWT é opcional e está desabilitada por padrão.

* É configurado ao iniciar o serviço em `config.json` com `auth_enabled`, `auth_jwt_secret`, `auth_accept_authorization_header`, `auth_accept_api_key_header` e `auth_api_key_header_name`.
* Os mesmos valores podem ser substituídos pelas variáveis de ambiente `FACEPHI_INE_REST_AUTH_*`.
* `GET /api/v1/health` e `GET /api/v1/version` permanecem públicos.
* `POST /api/v1/facial/authentication` requer um JWT válido quando a autenticação está habilitada.
* O serviço não expõe endpoints `GET/POST /config` em tempo de execução, por isso a configuração JWT só pode ser definida ao iniciar.