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

# Autenticar cliente

> Troca o client_id e o token do cadastro pelo client_token usado em todas as demais rotas.

**Rota:** `POST /api/v1/auth` · **Headers:** nenhum token (é a rota que gera o Client Token)

É a primeira chamada de qualquer integração. Ela recebe as chaves brutas enviadas por [infraestrutura@ticto.com.br](mailto:infraestrutura@ticto.com.br) e devolve o `access_token`, que passa a ser enviado no header `X-Api-Client-Token` em todas as outras rotas.

## Parâmetros obrigatórios (body)

<ParamField body="client_id" type="string" required>
  ID do cliente fornecido durante o cadastro.
</ParamField>

<ParamField body="token" type="string" required>
  Token do cliente fornecido durante o cadastro.
</ParamField>

## Exemplo

```bash cURL theme={null}
curl -X POST https://nexus-sandbox.ticto.dev/api/v1/auth \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_id": "<seu_client_id>",
    "token": "<seu_token>"
  }'
```

## Response de sucesso (200 OK)

<ResponseField name="access_token" type="string" required>
  Token de acesso do cliente (`client_token`). Envie-o no header `X-Api-Client-Token` nas demais rotas.
</ResponseField>

```json theme={null}
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
```

<Warning>
  Sandbox e Produção têm pares de chaves distintos. Na virada para produção, repita esta chamada na base URL de produção com as credenciais produtivas. Veja [Setup dos ambientes](/guia/ambientes#ambiente-de-producao).
</Warning>

<Note>
  Erros mais comuns: `401` para credenciais incorretas e `422` quando falta `client_id` ou `token` no body.
</Note>


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