Playground

La consola incluye un ejecutor que lanza cualquier operación contra la API real, con los datos de la cuenta que tiene la sesión abierta. Vive en la pestaña Playground de la sección API.

La llamada no se hace desde el navegador. La consola envía la petición al servidor, que la reenvía a la operación destino y devuelve la respuesta. La consecuencia práctica: la API key nunca viaja al navegador ni aparece en la respuesta, y una sesión abierta en un equipo compartido no la expone.

Qué se puede ejecutar

El ejecutor admite las operaciones de visibilidad pública. Las operaciones de administración quedan fuera, y los permisos de la cuenta se comprueban igual que en una llamada directa: el ejecutor no otorga acceso que la cuenta no tenga.

Por omisión las llamadas cuentan como reales en todos los sentidos: consumen cuota, producen efectos y aparecen en el historial de la cuenta. Ejecutar POST /v1/validate desde el ejecutor crea una validación.

Las operaciones que traen escenarios de simulación ofrecen además un interruptor de playground. Con él activado, la operación corre su tubería real con el paso externo sustituido por una respuesta preparada, dentro de una transacción que siempre se revierte: no se mide nada, no se entrega ningún webhook, no se envía ninguna notificación y no sobrevive ninguna fila. La respuesta lleva el estado que habría devuelto la operación real para el escenario elegido.

Plantillas

GET /v1/playground/templates devuelve cuerpos de ejemplo por operación, que el ejecutor precarga. Sirven como punto de partida editable, no como datos válidos: los identificadores y las cuentas de ejemplo no corresponden a registros reales.

Uso desde una integración

El ejecutor está pensado para probar desde la consola, no como capa de acceso. Una integración llama directamente a la operación destino con su propia API key, como describe la autenticación; pasar por el ejecutor añade un salto sin beneficio y exige una sesión de navegador.