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

# Autenticação

> Toda requisição é autenticada com uma API key da sua empresa.

A API pública usa **API keys** no formato `wd_live_<prefixo>_<segredo>`. Envie a key em um destes headers:

```bash X-API-Key (recomendado) theme={null}
curl https://wisedesk-api.wiseapp360.com/api/v1/tickets \
  -H "X-API-Key: wd_live_a1b2c3d4_..."
```

```bash Authorization: Bearer theme={null}
curl https://wisedesk-api.wiseapp360.com/api/v1/tickets \
  -H "Authorization: Bearer wd_live_a1b2c3d4_..."
```

## Criando e gerenciando keys

Somente **administradores** podem gerenciar keys, em **Configurações → API Keys**:

* **Escopos** — o que a key pode ler ou alterar. Veja [Escopos](/guias/escopos).
* **Expiração** — nunca, 30, 90 ou 365 dias. Keys expiradas retornam `401`.
* **Revogação** — imediata; leva até 60 segundos para propagar entre instâncias.
* **Último uso** — exibido na listagem, útil para identificar keys esquecidas.

> [!WARNING]
>
> A key completa é exibida **uma única vez**, na criação. O WiseDesk guarda apenas um hash (bcrypt). Se perdê-la, revogue e gere outra.

## Em nome de quem a key age

Cada key pertence a **uma empresa** e age em nome do **administrador que a criou**. Comentários, mensagens e tasks criados pela API aparecem com esse autor no histórico.

* Os dados retornados são sempre restritos à empresa da key — não há como acessar outra empresa.
* Campos `companyId` enviados no corpo das requisições são ignorados.

## Boas práticas

> **Uma key por integração**
>
> Facilita identificar a origem das chamadas e revogar sem afetar outras integrações.

> **Menor privilégio**
>
> Conceda apenas os escopos necessários. Um painel de BI precisa só de `analytics:read`.

> **Somente no back-end**
>
> Nunca exponha a key em apps web/mobile. Faça as chamadas a partir do seu servidor.

> **Rotação**
>
> Use expiração e gere uma nova key antes do vencimento.


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