Voltar ao blog
Tutorial 05 ago 2026 · 8 min de leitura

Como integrar verificação facial em 15 minutos com a API do ModFACE

Um guia direto: gere sua API key, cadastre um rosto com POST /faces e reconheça com POST /recognize. Sem SDK pesado, só REST.

1. Crie o evento e pegue a API key

No painel, crie um evento (a galeria isolada do seu tenant). A API key é exibida uma única vez — guarde-a. Toda chamada usa o header Authorization: Bearer <key>, e é ela que identifica o seu tenant, sem comparação cruzada com outros.

2. Cadastre um rosto — POST /faces

Envie o external_id (um identificador seu), o consentimento e a imagem (ou o embedding já extraído no navegador). A API devolve o embedding e a versão do modelo. No modelo de soberania do dado, você guarda esse embedding no seu banco.

3. Reconheça — POST /recognize

Na hora da verificação, envie a captura e a galeria de embeddings. A API confirma o liveness, compara e devolve confirmado + external_id + score. Match acima do limiar é faturável (R$ 0,35); no-match e falha de liveness não custam nada.

4. Trate a resposta

O ModFACE identifica; a regra de negócio é sua. Marque presença, libere o acesso ou registre o ponto conforme o external_id retornado. Em caso de resposta ambígua, apresente o modal de resolução e chame o endpoint de resolve. Pronto — verificação facial no ar.

Pronto pra integrar verificação facial?

Veja a documentação da API e coloque o ModFACE no seu produto.