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

# Visão geral

> A API pública da Legitimuz tem uma rota. O que ela faz, como autentica e o que fica do lado do widget.

A API pública tem uma rota: `POST /public/verifications`. O seu servidor cria a verificação com
ela, e tudo o que precisa saber depois chega por [webhook](/webhooks/introduction).

```text theme={null}
https://api.legitimuz.com
```

Sandbox e produção usam o mesmo host. O que separa os dois é a chave.

## O ciclo

<Steps>
  <Step title="O seu servidor cria a verificação">
    [`POST /public/verifications`](/api/create-verification) com o header `X-API-Key`. Devolve o
    `public_id` e a entrada da jornada.
  </Step>

  <Step title="A pessoa percorre a jornada">
    O widget abre com a credencial que veio na entrada e conversa com a Legitimuz sozinho.
  </Step>

  <Step title="O seu servidor recebe a decisão">
    [`verification.decided`](/webhooks/events#verificationdecided) chega assinado ao seu endpoint.
  </Step>
</Steps>

<Info>
  As rotas que o widget usa durante a jornada não são contrato público. Elas mudam junto com as
  telas. Chame só `POST /public/verifications`.
</Info>

## Autenticação

Header `X-API-Key`, com a chave da integração (`lz_...`). A chave não é aceita no corpo nem na
query string. Detalhes em [autenticação](/start/authentication).

## Convenções

* Datas em ISO 8601, em UTC.
* `schema_version` no topo de todo corpo. Hoje, `"1.0"`.
* Requisições usam schema fechado: campo desconhecido é recusado.
* Respostas são aditivas: campo novo pode aparecer, e o seu cliente ignora o que não conhece.
* Toda resposta traz `X-Request-Id`. Registre-o: é o que localiza uma chamada no suporte.

## Páginas

<Columns cols={3}>
  <Card title="Criar verificação" icon="plus" href="/api/create-verification">
    Corpo, resposta, idempotência e códigos.
  </Card>

  <Card title="Status" icon="list-check" href="/api/verification-status">
    Os cinco valores e o que cada um significa.
  </Card>

  <Card title="Erros e limites" icon="alert-triangle" href="/api/errors">
    O envelope, o catálogo e o comportamento diante de `429`.
  </Card>
</Columns>