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

# Autentique sua integração

> Use OAuth 2.0 com client credentials para acessar a Onbeef Connect API.

A Onbeef Connect API usa OAuth 2.0 com o grant `client_credentials`. Você troca o `client_id` e o `client_secret` por um token e envia esse token em cada requisição.

## Fluxo de autenticação

<Steps>
  <Step title="Gere as credenciais">
    Copie o `client_id` e o `client_secret` na área **Integrações** do Onbeef App.
  </Step>

  <Step title="Obtenha um token">
    Envie as credenciais para `POST /oauth/token`.
  </Step>

  <Step title="Envie o token">
    Inclua o token no header de cada requisição:

    ```http theme={null}
    Authorization: Bearer <access_token>
    ```
  </Step>
</Steps>

## Validade

O campo `expires_in` informa a validade em segundos. A resposta atual usa `43200`, equivalente a 12 horas.

Solicite outro token quando o atual expirar. Uma credencial inválida ou um token expirado pode retornar `401`.

<CardGroup cols={2}>
  <Card title="Ver a requisição completa" icon="key" href="/api-reference/auth/token">
    Consulte os campos, respostas e exemplos do endpoint de token.
  </Card>

  <Card title="Fazer a primeira chamada" icon="bolt" href="/quickstart">
    Teste a autenticação no ambiente sandbox.
  </Card>
</CardGroup>