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

# Fluxo comum

Os serviços de validação que funcionam **por referência** compartilham o mesmo fluxo inicial: obter o token, ter uma operação e enviar os assets para o armazenamento. Só então o serviço específico é chamado com as chaves obtidas.

Esta página reúne esse fluxo inicial para evitar repeti-lo em cada serviço. Cada etapa leva à página que documenta seu contrato.

### Diagrama

```mermaid
sequenceDiagram
    actor C as Consumer
    participant API as Middleware API v2

    C->>API: POST /consumer/token
    API-->>C: token de consumer (validade de 1 h)

    C->>API: POST /operation
    API-->>C: operationId + expiresAt

    loop Para cada asset: frente, verso, selfie
        C->>API: POST /storage (conteúdo + contexto)
        API-->>C: fileKey
    end

    C->>API: Serviço de validação (fileKeys + operation-id)
    API-->>C: Resultado do serviço
```

### As etapas

1. **Obter o token de consumer.** Um único token autentica todas as chamadas seguintes e é válido por uma hora. Ele é emitido em nome da plataforma e para um consumer específico. Consulte [Autenticação](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/autenticacion.md).
2. **Criar a operação.** A operação agrupa os assets da sessão e define um prazo de validade para eles. Ela é criada com `POST /operation`, que retorna o `operationId` e seu `expiresAt`. É recomendável criá-la **quando a captura começa**, e não antes, porque a contagem do prazo de validade começa nesse momento. Consulte [Criar operação](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/operations/create-operation.md).
3. **Enviar cada asset.** Uma chamada por captura, declarando o **contexto** correspondente. Cada envio retorna a `fileKey` que será usada depois para referenciar o asset. Consulte [Salvar asset](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/storage/save-asset.md), e [Armazenamento](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/storage.md) para ver os contextos disponíveis e o formato da chave.
4. **Chamar o serviço de validação.** São enviadas as `fileKeys` **exatamente como retornadas por** `POST /storage`, junto com o `operationId` no cabeçalho `operation-id`. A chave não é composta nem interpretada: adicionar contexto por conta própria a deixa duplicada, e o asset não é resolvido. Se precisar recuperar as chaves de uma operação, elas estão em [Get File Keys](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/operations/get-file-keys.md).

### Quais serviços seguem esse fluxo

Os serviços de validação **de identidade** aceitam, por padrão, os dois modos de asset: conteúdo em linha e referência por chave. Este fluxo é o do modo por referência. As exceções são explícitas:

| Serviço                                                                                                                                                                                                                                               | Modos aceitos                                 |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| [Form OCR](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/document-services/form-ocr.md)                                                                                                                                              | Somente conteúdo em linha                     |
| [Voice Enrollment](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/voice-services/voice-enrollment.md) e [Voice Authentication](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/voice-services/voice-authentication.md) | Somente conteúdo em linha, sem campo `source` |
| [Document Validation](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/document-services/document-validation.md)                                                                                                                        | Somente referência, sem campo `source`        |

Os serviços exclusivamente em linha não passam pelas etapas 2 e 3: o conteúdo é enviado na própria chamada, e eles não incluem o cabeçalho `operation-id`.
