> ## 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.

# Autenticación

> Cómo autenticarte con la API de Mindo usando tu API Key

# Autenticación

Todas las solicitudes a la API de Mindo requieren autenticación mediante una API Key enviada en el header `X-API-Key`.

## Header de autenticación

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

## Ejemplos

<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>

## Errores de autenticación

| Código | Mensaje                                                                 | Causa                                           |
| ------ | ----------------------------------------------------------------------- | ----------------------------------------------- |
| `401`  | `"Este endpoint requiere autenticacion con API Key (header X-API-Key)"` | No se envió el header `X-API-Key`               |
| `401`  | `"API Key expirada"`                                                    | La API Key expiró o fue revocada                |
| `403`  | `"API Key no tiene acceso a este recurso"`                              | La API Key no tiene permisos para este endpoint |

<Warning>
  **Seguridad de tu API Key**

  * Nunca expongas tu API Key en código del lado del cliente (frontend, apps móviles).
  * Usa variables de entorno para almacenarla en tus aplicaciones.
  * Rota tu API Key periódicamente desde el [Dashboard](https://app.mindosoftware.com).
  * Si crees que tu API Key fue comprometida, revócala inmediatamente desde el Dashboard.
</Warning>