> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.laposta.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.laposta.org/_mcp/server.

# ¿Cómo funciona la autenticación con tu clave API?

> La API utiliza basic auth, con tu clave como nombre de usuario y una contraseña vacía.

Para cada llamada a través de https necesitas una clave API. La clave determina la cuenta en la que trabajas: no hay un nombre de usuario independiente ni un token que caduque.

## Enviar tu clave

La autenticación se realiza mediante basic auth. Introduce tu clave como nombre de usuario y deja la contraseña en blanco. En curl, pon dos puntos después de la clave; de lo contrario, curl te pedirá una contraseña de todos modos.

Puedes leer cómo funciona esto con el botón «Try it» de esta documentación en [Probar la API con Try it](/api-uitproberen).

```bash
curl https://api.laposta.nl/v2/list \
  -u TU_CLAVE_API:
```

Si no envías una clave válida, la API devuelve un mensaje de error `401`:

```json
{
  "error": {
    "type": "invalid_request",
    "message": "No valid API-key provided"
  }
}
```

## Crear una clave

Puedes crear claves en tu cuenta, en «Conectar». Para saber cómo hacerlo exactamente, qué información de la clave puedes seguir viendo después y cuántas claves puedes crear, consulta [Crear una clave API](/hoe-kom-ik-aan-een-api-sleutel).

## Uso seguro de tu clave

Una clave da acceso a todos los datos de la cuenta, así que trátala como una contraseña.

> **Warning**
>
> No pongas nunca tu clave en código que se ejecute en el navegador, ni tampoco en un repositorio público. Cualquiera que la tenga podrá extraer tus suscriptores y enviar campañas.

En su lugar, utiliza una variable de entorno o el gestor de secretos de tu proveedor de alojamiento y haz que las llamadas se realicen desde tu propio servidor. Si quieres hacer pruebas, utiliza una lista aparte en tu propia cuenta. Hazlo sobre todo con los endpoints que crean o eliminan datos. Por lo general, no es posible crear una cuenta gratuita de prueba aparte: ver [Una cuenta gratuita por organización](/er-is-al-een-gratis-account-voor-je-organisatie).

## Artículos relacionados

#### [Crear una clave API](/hoe-kom-ik-aan-een-api-sleutel)

Puedes crear y gestionar tus claves API en la página Conectar. Atención: una nueva…

#### [Hacer tu primera llamada a la API](/je-eerste-api-aanroep)

Haz tu primera llamada a la API y solicita tus listas, directamente en este sitio web o…

#### [¿Cuáles son los límites y mensajes de error de la API?](/api-limieten-en-foutmeldingen)

Cuántas solicitudes por minuto permite la API y qué códigos de estado y de error puedes…