> 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/api-rest/midapi-v2/daf.md).

# DAF (Anti-fraude de documentos)

**DAF (Document Anti-Fraud)** é um serviço que analisa o Documento de identidade (e, opcionalmente, uma selfie) e determina se são autênticos e consistentes entre si. O serviço se integra como parte do ecossistema de APIs da Facephi.

A partir do documento (e, se for fornecida, da selfie), DAF executa um conjunto de validações antifraude e retorna um diagnóstico único:

* **APROVADO**: o documento (e, no seu caso, a correspondência com a selfie) supera as validações.
* **RECUSADO**: é detectada uma inconsistência, manipulação ou não conformidade de qualidade/formato que impede a validação do documento.

### Natureza assíncrona

DAF é um serviço assíncrono: a chamada que inicia a validação não bloqueia enquanto aguarda o resultado. Responde imediatamente com um identificador de transação (`transactionId`) e o consumidor obtém o resultado por meio de consultas de estado (polling).

### Fluxo de Integração

A integração típica segue estas etapas:

1. Obter um [Token do consumidor](/docs.facephi-pt-br/api-rest/midapi-v2/autenticacion.md) válido para autenticar todas as chamadas.
2. [Fazer upload dos arquivos](/docs.facephi-pt-br/api-rest/midapi-v2/daf/subida-de-assets.md) do documento (e, opcionalmente, da selfie) para o serviço de armazenamento, obtendo uma `fileKey` para cada um.
3. [Iniciar a validação](/docs.facephi-pt-br/api-rest/midapi-v2/daf/iniciar-validacion.md) no DAF enviando as `fileKeys` obtidas. O DAF responde imediatamente com um `transactionId`.
4. [Consultar o estado](/docs.facephi-pt-br/api-rest/midapi-v2/daf/consultar-estado.md) da transação por polling até obter um estado terminal.

### Resumo dos endpoints

| Endpoint                  | Método | Descrição                                                                                                   |
| ------------------------- | ------ | ----------------------------------------------------------------------------------------------------------- |
| `/consumer/token`         | POST   | Emite o Token JWT do consumidor (validade de 1 h). Requer os cabeçalhos `platform-id` e `platform-api-key`. |
| `/storage`                | POST   | Faz upload de um arquivo (documento ou selfie) e retorna sua `fileKey`.                                     |
| `/v2/daf/validate`        | POST   | Inicia uma validação DAF. Responde `202` com `transactionId`.                                               |
| `/v2/daf/{transactionId}` | GET    | Consulta o estado/resultado de uma transação (polling).                                                     |