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

# Autenticação

> Como autenticar na API Mindo usando sua API Key

# Autenticação

Todas as requisições à API Mindo exigem autenticação via API Key enviada no header `X-API-Key`.

## Header de autenticação

```
X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx
```

## Exemplos

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET https://api.mindosoftware.com/api/v1/business-accounts/ \
    -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
  ```

  ```python Python theme={null}
  import requests

  headers = {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
  }

  response = requests.get(
      "https://api.mindosoftware.com/api/v1/business-accounts/",
      headers=headers
  )
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.mindosoftware.com/api/v1/business-accounts/",
    {
      headers: {
        "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  );
  ```
</CodeGroup>

## Erros de autenticação

| Código | Mensagem                                                                | Causa                                          |
| ------ | ----------------------------------------------------------------------- | ---------------------------------------------- |
| `401`  | `"Este endpoint requiere autenticacion con API Key (header X-API-Key)"` | O header `X-API-Key` não foi enviado           |
| `401`  | `"API Key expirada"`                                                    | A API Key expirou ou foi revogada              |
| `403`  | `"API Key no tiene acceso a este recurso"`                              | A API Key não tem permissão para este endpoint |

<Warning>
  **Segurança da API Key**

  * Nunca exponha sua API Key em código do lado do cliente (frontend, apps mobile).
  * Use variáveis de ambiente para armazená-la em suas aplicações.
  * Rotacione sua API Key periodicamente pelo [Dashboard](https://app.mindosoftware.com).
  * Se acreditar que sua API Key foi comprometida, revogue-a imediatamente pelo Dashboard.
</Warning>