Playground

El Playground (barra lateral > Playground) te permite ejecutar requests de API en vivo con tu clave real sin escribir código. Es la forma más rápida de probar un nuevo sitio de destino, depurar una response complicada o comparar Single, Proxy y Browser lado a lado.

Ábrelo en foura.ai/dashboard#playground.

Qué hace

Un formulario. Tres motores. Tráfico real.

• Single: fetch HTTP directo con características de red realistas similares a las de un navegador
• Proxy: fetch a través de un proxy rotatorio gestionado
• Browser: abre la URL en una instancia del navegador Chrome para sitios renderizados con JS

Las requests se ejecutan con la API key que selecciones en la parte superior de la página. El uso se descuenta de la cuota de esa clave de la misma manera que lo haría una llamada de producción, así que no agotes tu plan en las pruebas.

Seleccionar una clave

El menú desplegable de API keys muestra todas las claves activas dentro de tu alcance: claves personales, claves de organización que administras y claves compartidas con el equipo a las que puedes acceder. Selecciona la clave a la que deseas que se le facture la request. Si aún no tienes ninguna clave activa, un aviso en pantalla te enlazará a la página de API Keys para crear una.

Elegir un producto

Tres pestañas se encuentran sobre el formulario: Single, Proxy, Browser. Al cambiar de pestaña se modifican los campos visibles y el motor al que llega la request. La selección actual se conserva al recargar la página.

Producto	Cuándo usarlo
Single	Fetch HTTP rápido. La mejor primera opción para cualquier URL.
Proxy	El mismo fetch con rotación automática de proxy. Úsalo cuando Single se bloquee continuamente.
Browser	Carga la página en una instancia del navegador Chrome. Úsalo cuando los datos solo aparezcan después de ejecutar JavaScript.

Construir la request

Fila de URL

La fila superior contiene el método HTTP (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS), la URL de destino y el botón Send. Single + Proxy admiten todos los métodos. Browser ignora el método (Chrome siempre emite un GET para la navegación) y el body.

Pestañas de la request

Debajo de la fila de la URL, cinco pestañas te permiten completar todo lo demás:

Pestaña	Qué controla
UI	Campos de formulario para timeouts, redirecciones, flags, proxy, opciones específicas del navegador y reglas de validación
Body	Body de formato libre para requests POST / PUT / PATCH
Headers	Headers de request personalizados como pares clave-valor
Cookies	Cookies para enviar con la request
Raw	El payload JSON exacto que se enviará, editable directamente

Cualquier cambio que realices en UI / Body / Headers / Cookies se reflejará en Raw. Editar Raw también funciona, y las demás pestañas se actualizarán para coincidir.

Secciones del panel de UI

La pestaña UI agrupa las configuraciones en secciones colapsables. Los campos vacíos recurren al valor predeterminado del esquema del motor.

• Timeouts: timeout_ms, connect_timeout_ms, accept_timeout_ms, server_response_timeout_ms, dns_cache_timeout_sec
• Redirects: activa/desactiva y establece followRedirects (0-20). Solo para Single + Proxy. Browser sigue las redirecciones por su cuenta.
• Flags: unblocker, tryJsonData, returnBuffer. Single + Proxy.
• Proxy: elige un ID de proxy específico para Single o Browser, o establece maxTries, el timeout externo de Proxy y ignoreProxies para el motor Proxy.
• Browser: opciones exclusivas del navegador como checkStatus y checkText.
• Validate: reglas de aceptación/fallo para validate.status (códigos de estado), validate.headers (reglas de clave-valor de headers) y validate.data (subcadenas de aceptación/fallo del body, alternativas separadas por |).

Los campos que no se aplican al producto seleccionado actualmente se ocultan.

Restablecer barra de herramientas

El botón Reset en la barra de herramientas (junto a History) restablece el formulario del producto activo a los valores predeterminados. Los valores predeterminados mantienen activados unblocker y tryJsonData, que coinciden con el punto de partida más común. Úsalo cuando te hayas desviado mucho de una base de referencia que funcione y desees empezar de cero sin recargar la página.

Enviar y cancelar

Haz clic en Send para enviar la request. La columna derecha cambia a un estado de carga con un indicador de progreso y un botón Cancel mientras la llamada está en curso. Haz clic en Cancel (o presiona el botón nuevamente en dispositivos móviles) para abortar. Una request cancelada restaura el marcador de posición inactivo con "Request canceled." en lugar de mostrar un error.

La tarjeta de response cambia al resultado en el momento en que la request se completa (o falla).

Leer la response

La columna de response refleja el diseño de la request con sus propias pestañas:

Pestaña	Qué muestra
Body	Body analizado. Cambia entre las vistas JSON, HTML y Text según lo que se haya devuelto.
Headers	Headers de response, uno por línea.
Cookies	Cookies devueltas por el destino, tanto en la vista analizada (agrupada por host) como en la vista raw (texto Set-Cookie). La vista analizada muestra una etiqueta HO en las cookies de solo host; las cookies de dominio no tienen marca.
Raw	El contenedor JSON completo devuelto por la API.

Una barra de metadatos sobre las pestañas muestra el estado HTTP de origen, el tiempo total y (para las requests de Proxy / single-with-proxy-id) el ID de proxy que gestionó la llamada. Los botones de copiar y descargar se encuentran en la parte superior derecha de cada panel, lo que te permite extraer el body o los headers a un archivo con un solo clic.

Expandir a pantalla completa

El icono de expandir en la barra de herramientas de response extrae la tarjeta de response del diseño dividido y la muestra en una superposición a pantalla completa. Úsalo para árboles JSON profundos, volcados Set-Cookie extensos o bodies HTML anchos donde la columna de ancho medio resulta estrecha. La página en sí deja de desplazarse mientras la superposición está abierta. Haz clic en el icono de nuevo (o presiona Escape) para contraerla.

El reproductor curl

Debajo de la response, un bloque curl muestra el comando de línea de comandos exacto equivalente a la request que acabas de construir. Cópialo para reproducir la request desde una terminal, compartirlo con un compañero de equipo o pegarlo en un informe de errores.

Para las claves revelables, un botón Reveal key junto al fragmento de código coloca la clave real en texto plano directamente en el comando curl para que puedas copiarlo y ejecutarlo tal cual. Haz clic de nuevo para ocultarla. Las claves heredadas (creadas antes de que se lanzara la función de revelado) mantienen un marcador de posición PASTE_PLAINTEXT_FOR_<key-name>; regenera la clave desde la página de API Keys para que sea revelable.

La acción de revelar se registra en el historial de auditoría del servidor cada vez, y la clave en texto plano solo permanece en memoria durante la sesión de la página actual.

Guardar presets

Si te encuentras reconfigurando el mismo destino repetidamente, guárdalo. Haz clic en Save en la fila de pestañas de la request para almacenar la configuración actual como un preset con nombre.

Abre Saved en la barra de herramientas para explorar, renombrar o eliminar tus presets. Haz clic en cualquier preset para volver a cargarlo en el formulario.

Campo del preset	Qué almacena
Name	Una etiqueta corta (hasta 100 caracteres)
Description	Notas opcionales (hasta 500 caracteres)
Endpoint	Para qué producto es el preset (single / proxy / browser)
Config	El payload completo de la request, incluidos los campos de UI, headers, cookies y body

Los presets están limitados a tu cuenta de usuario y no se comparten con los miembros del equipo.

Reejecutar desde el historial

Cada request que ejecutas se registra. Abre History en la barra de herramientas para ver tus últimas 20 ejecuciones, ordenadas de la más reciente a la más antigua.

Cada fila muestra el endpoint, la URL de destino, el estado y la hora. Haz clic en Replay en cualquier fila para volver a cargar esa request en el formulario, luego haz clic en Send para ejecutarla de nuevo.

El historial se limita automáticamente a tu cuenta: solo verás tus propias ejecuciones.

Abrir desde Activity

El diálogo de detalles del Activity Log tiene un botón Open in Playground. Haz clic en él y el Playground se cargará tanto con la request archivada como con la response archivada. El formulario se completa a partir del payload almacenado, y la tarjeta de response muestra lo que la API devolvió en ese momento con una etiqueta "archived" en la barra de metadatos del proxy ("archived [· truncated] [· via ]").

Desde allí puedes cambiar un parámetro y presionar Send para ejecutar una nueva request contra la API en vivo, o simplemente inspeccionar el payload archivado sin volver a ejecutarlo. Los payloads se conservan durante 24 horas, por lo que las filas de Activity más antiguas no tendrán una response recargable.

Consejos

• Comienza en el Playground antes de escribir código para un nuevo destino. Sabrás en cuestión de segundos si Single es suficiente o si necesitas Browser.
• Guarda un preset para cada destino que extraigas (scrape) con regularidad. Reejecutar un preset guardado requiere un solo clic; reconstruir la request de memoria lleva más tiempo.
• Utiliza la pestaña Cookies para depurar la extracción basada en sesiones. La vista raw de Set-Cookie muestra exactamente lo que envió el destino.
• Las requests del Playground se facturan a la clave que elijas. Utiliza una clave dedicada de cuota baja para la exploración informal si deseas mantener limpio el uso de producción.

Relacionado

• API Endpoints: Referencia completa de parámetros para los tres productos
• Elegir el Endpoint adecuado: Cuándo elegir Single frente a Proxy o Browser
• API Keys: Administra las claves con las que autenticas las requests del Playground
• Activity Log: Abre una request anterior directamente en el Playground
• Vista general del Dashboard: Todas las secciones de la barra lateral