> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vu-one.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentação técnica da VU

> Documentação de integração da VU Security: VU Identity Link para verificação de identidade ponta a ponta e VU Cloud Services: ID Analysis, Face Analysis, Antispoofing Facial e Connection Fingerprint.

Referência de integração dos produtos de identidade da VU. Tudo o que segue foi escrito para quem vai escrever o código: endpoints, contratos, códigos de erro e as armadilhas que só aparecem em produção.

<Warning>
  **A API do VU Identity Link está disponível apenas nos planos Premium e Pro.** O plano Basic não tem acesso por API: `POST /oauth/token` responde `401 invalid_client`. Veja [Planos](/pt/identity-link/planos) para saber o que cada plano inclui.
</Warning>

<CardGroup cols={2}>
  <Card title="VU Identity Link" icon="link" horizontal href="/pt/identity-link/introducao">
    **Verificação de identidade ponta a ponta.** Links de uso único, captura documental, OCR, prova de vida e fluxo adaptativo. Uma integração resolve o processo inteiro.

    `OAuth2` · `REST` · `Webhooks`
  </Card>

  <Card title="VU Cloud Services" icon="cloud" horizontal href="/pt/vucs/introducao">
    **APIs que você integra uma a uma.** O ID Analysis lê o documento, o Face Analysis compara os rostos, o Antispoofing Facial confirma que a selfie é de uma pessoa real e o Connection Fingerprint identifica o dispositivo.

    `Api-Key` · `REST` · `Sem SDK` · **Disponível**
  </Card>
</CardGroup>

## O que você pode fazer com o Identity Link

<CardGroup cols={2}>
  <Card title="1. Verifique qualquer pessoa em três passos" icon="wand-magic-sparkles" href="/pt/identity-link/links">
    Você cria um link, compartilha e lê o resultado. `POST /links` devolve um `linkUrl` que você envia pelo canal que já usa com seu cliente: e-mail, WhatsApp, SMS ou um QR code. Sem app para instalar nem SDK para publicar: roda no navegador que a pessoa já tem.
  </Card>

  <Card title="2. Os documentos do seu cliente não viajam pelo WhatsApp" icon="shield-halved" href="/pt/identity-link/planos#quando-a-janela-fecha">
    Você compartilha um link, não a foto de um documento. O documento e a selfie vão direto para a VU dentro da sessão do próprio link, que é de uso único e fecha num relógio definido por você. Passada essa janela a API responde `410` para o registro e `404` para as imagens, não importa o que o app de mensagens ainda guarde.
  </Card>

  <Card title="3. Vá para o Premium e integre por API" icon="code" href="/pt/identity-link/autenticacao">
    OAuth2 client credentials, uma API REST e webhooks assinados com HMAC-SHA256 para que seu servidor possa confiar no que recebe. O Premium sobe a cota para 100 verificações por mês e libera a personalização completa: seu nome, seu logo e sua cor em cada tela que seu cliente vê.
  </Card>

  <Card title="4. Vá para o Pro e ajuste às suas regras" icon="sliders" href="/pt/identity-link/planos#mudar-de-plano">
    O suporte configura sua cota de verificações e as duas janelas de expiração nos valores exatos de que você precisa, em minutos e não em opções fixas. O Pro também é o único plano que pode rodar fora do SaaS compartilhado.
  </Card>

  <Card title="5. O cliente que volta se verifica com uma selfie" icon="user-check" href="/pt/identity-link/prova-de-vida">
    O fluxo adaptativo leva o cliente que já se verificou para uma ramificação só de rosto e pula por completo a captura documental. O endpoint de status informa qual ramificação rodou em `method`: `FACE` ou `DOCUMENT`. Disponível a partir da versão 2.2.0.
  </Card>
</CardGroup>

## Começar em cinco minutos

<CodeGroup>
  ```bash 1. Obter um token theme={null}
  curl -X POST https://api.identity.vu-one.com/api/v1/oauth/token \
    -H "Authorization: Basic $(printf '%s' "$CLIENT_ID:$CLIENT_SECRET" | base64)" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -d "grant_type=client_credentials"
  ```

  ```bash 2. Criar um link theme={null}
  curl -X POST https://api.identity.vu-one.com/api/v1/links \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"type":"FULL FLOW","externalUserId":"cliente-12345"}'
  ```

  ```bash 3. Consultar o resultado theme={null}
  curl "https://api.identity.vu-one.com/api/v1/verifications/$VERIFICATION_ID/status?linkId=$LINK_ID"
  ```
</CodeGroup>

<Note>
  O endpoint de status é **público** e exige o parâmetro `linkId` desde a versão 2.2.0. Ele não leva `Authorization`. Os detalhes estão em [Autenticação](/pt/identity-link/autenticacao) e [KYC](/pt/identity-link/kyc).
</Note>

## Ir direto ao que você precisa

| Se você precisa… | Página |
| - | - |
| Autenticar suas chamadas | [Autenticação](/pt/identity-link/autenticacao) |
| Criar um link de verificação | [Links](/pt/identity-link/links) |
| Ler o resultado e os dados do documento | [KYC](/pt/identity-link/kyc) |
| Entender a prova de vida e o fluxo adaptativo | [Prova de vida](/pt/identity-link/prova-de-vida) |
| Receber eventos no seu servidor | [Webhooks](/pt/identity-link/webhooks) |
| Resolver um código HTTP inesperado | [Erros](/pt/identity-link/erros) |
| Ler um documento de identidade por API | [ID Analysis](/pt/vucs/id-analysis/introducao) |
| Comparar dois rostos | [Face Analysis](/pt/vucs/face-analysis/introducao) |
| Detectar uma selfie falsificada | [Antispoofing Facial](/pt/vucs/antispoofing-facial/introducao) |
| Identificar o dispositivo de uma conexão | [Connection Fingerprint](/pt/vucs/connection-fingerprint/introducao) |
| Ver o que mudou na API | [Changelog](/pt/identity-link/changelog) |

## URLs base

| Serviço | URL base | Autenticação |
| - | - | - |
| VU Identity Link API | `https://api.identity.vu-one.com/api/v1` | `Authorization: Bearer` |
| ID Analysis | Fornecida pela VU por ambiente | `Api-Key` |
| Face Analysis | Fornecida pela VU por ambiente | `Api-Key` |
| Antispoofing Facial | Fornecida pela VU por ambiente | `Api-Key` |
| Connection Fingerprint | `https://fingerprint.api.vusecurity.com` | Nenhuma no endpoint principal |

<Warning>
  As api-keys e os `clientSecret` vivem no seu backend, em um gerenciador de segredos. Nunca dentro de um app móvel nem de um bundle de frontend: qualquer pessoa consegue extraí-los do binário.
</Warning>

## Recursos

<CardGroup cols={3}>
  <Card title="Changelog" icon="clock-rotate-left" href="/pt/identity-link/changelog">
    Versões, mudanças de comportamento e recomendações de migração.
  </Card>

  <Card title="Wiki" icon="arrow-up-right-from-square" href="https://wiki.corp.vusecurity.com/es/home">
    Documentação interna adicional para as equipes da VU.
  </Card>

  <Card title="Suporte" icon="life-ring" href="mailto:customer.support@vusecurity.com">
    Escreva com o `id` da transação, o ambiente e o carimbo de tempo.
  </Card>
</CardGroup>

***

A VU Security é a plataforma de identidade digital da América Latina. O material não técnico — soluções por caso de uso, indústrias, certificações e sobre a VU — fica em [vusecurity.com](https://vusecurity.com).


## Related topics

- [Changelog da Identity Link API](/pt/identity-link/changelog.md)
- [Documentación técnica de VU](/index.md)
- [Códigos de Erro e Respostas da Identity Link API](/pt/identity-link/erros.md)
- [VU Cloud Services](/pt/vucs/introducao.md)
- [Integrar o Antispoofing Facial](/pt/vucs/antispoofing-facial/integracao.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.