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

# Probar la API con Try it

> Envía desde tu navegador una llamada real a la API de Laposta, sin instalar nada.

En la página de cada endpoint encontrarás el botón «Try it» en la esquina superior derecha del ejemplo de código. Con él puedes rellenar los parámetros en un formulario y enviar la llamada desde tu navegador. La respuesta aparece debajo: es el mismo JSON que obtendrías en tu propio código.

## Introducir la clave API

En la parte superior del formulario, pega tu clave API en el campo «api_key». No hay ningún campo de contraseña, porque la API no la necesita. Puedes leer por qué en [Autenticación con tu clave API](/api-authenticatie).

Tu clave permanece en tu propio navegador y no se envía a los creadores de este sitio. La solicitud va directamente de tu navegador a `api.laposta.nl`, a través de https.

## Atención: es una llamada real

No existe un entorno de pruebas independiente. Si introduces una clave válida y envías una llamada que crea algo, se creará de verdad en tu cuenta.

> **Warning**
>
> Por tanto, no utilices la clave de una cuenta con una base de datos de suscriptores real mientras estés haciendo pruebas. Ten cuidado también si trabajas en un ordenador compartido: tu clave queda guardada en ese navegador hasta que la borres.

Si no introduces nada en absoluto, no pasará nada grave. La llamada se enviará sin clave y la API responderá con un `401`, ya que sin clave la API no sabe de qué cuenta se trata. Este mensaje de error se explica en [Autenticación con tu clave API](/api-authenticatie).

## Probar de forma segura con una lista aparte

Puedes hacer pruebas de forma segura creando una lista de prueba aparte en tu cuenta. Crea una única lista, anota el `list_id` y dirige a ella todas tus llamadas de prueba. Así, tus listas reales permanecerán intactas aunque algo salga mal.

Crear una cuenta gratuita de prueba aparte no suele ser una opción, ver [Una cuenta gratuita por organización](/er-is-al-een-gratis-account-voor-je-organisatie). Si como desarrollador necesitas realmente un entorno aislado, ponte en contacto con el servicio de asistencia a través de [helpdesk@laposta.nl](mailto:helpdesk@laposta.nl). Sí es posible crear varias cuentas de pago, agrupadas en un entorno de gestión.

## Endpoints sin Try it

En algunos endpoints se ha omitido a propósito el botón «Try it», porque esas llamadas no se pueden deshacer o se ejecutan automáticamente:

| Endpoint                                                            | Por qué no                                                     |
| ------------------------------------------------------------------- | -------------------------------------------------------------- |
| Todos los endpoints de eliminación                                  | el objeto desaparece después de forma definitiva               |
| [Vaciar una lista](/lijsten/lijst-leegmaken)                        | elimina todos los suscriptores de la lista                     |
| [Sincronizar lista (en bloque)](/lijsten/lijst-synchroniseren-bulk) | modifica de una vez hasta 500 000 suscriptores                 |
| [Enviar campaña](/campagnes/campagne-verzenden)                     | envía correo electrónico real a destinatarios reales           |
| [Programar campaña](/campagnes/campagne-inplannen)                  | deja lista una campaña que se enviará en el momento programado |

Los ejemplos de código sí están disponibles en esas páginas, para que veas exactamente cómo es la llamada.

## Elegir el lenguaje de programación

Encima del ejemplo de código puedes elegir el lenguaje de programación. En la propia página del endpoint hay nueve opciones, desde cURL y PHP hasta Python, Go y Swift. En la pantalla de «Try it» aparecen tres (cURL, JavaScript y Python), porque es la visualización de los datos que acabas de introducir y no la lista completa.

## Artículos relacionados

#### [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…

#### [¿Cómo funciona la autenticación con tu clave API?](/api-authenticatie)

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

#### [¿Cuáles son los errores más comunes con la API?](/veelgemaakte-fouten-met-de-api)

Errores habituales al conectar con la API de Laposta, con el mensaje de error que…