Playground

El Playground (barra lateral > Playground) te permite ejecutar requests reales a la API con tu key auténtica sin escribir código. Es la forma más rápida de probar un nuevo sitio objetivo, depurar una response complicada o comparar Auto, Single, Proxy y Browser lado a lado.

Ábrelo en foura.ai/dashboard#playground.

Qué hace

Un formulario. Cuatro motores. Tráfico real.

  • Auto: fetch inteligente. Envías una URL junto con una regla validate y FourA elige la ruta más económica que funcione.
  • Single: fetch HTTP directo con características de red realistas similares a las de un navegador
  • Proxy: fetch mediante proxy rotatorio administrado, opcionalmente delimitado a países visibles para el objetivo
  • Browser: abre la URL en una instancia de Chrome para sitios renderizados con JS

Las requests se ejecutan con la API key que elijas en la parte superior de la página. El consumo cuenta para la cuota de esa key igual que una llamada en producción, así que no agotes tu plan durante las pruebas.

Elegir una key

El menú desplegable de API keys muestra todas las keys activas que puedes usar: las tuyas en My Keys, y luego un grupo por cada organización a la que perteneces. Cualquier miembro puede ejecutar la key de una organización, y una request realizada con ella consume el plan del propietario de la organización. Elige aquella a la que quieras facturar la request. Si aún no tienes keys activas, un aviso integrado te enlaza a la página API Keys para crear una.

Elegir un modo

Una fila superior de Mode alterna entre Auto y los motores manuales. Cuando se selecciona Auto, el formulario cambia a la interfaz mínima de Auto (URL más validate y algunos ajustes). Siempre se muestran ambas filas: Mode: Auto, y Endpoint: Single, Proxy, Browser. Seleccionar uno deselecciona el otro. Cambiar de endpoint modifica qué campos son visibles y a qué motor llega la request. La selección actual se mantiene al recargar la página.

Modo Cuándo usarlo
Auto Nuevo objetivo o sitio con protección mixta. Auto elige la ruta más económica y recuerda lo que funciona.
Single Fetch HTTP rápido. La mejor primera opción para un host conocido.
Proxy El mismo fetch con rotación automática de proxy. Configura exitCountries cuando necesites un país visible para el objetivo.
Browser Carga la página en una instancia de Chrome. Úsalo cuando los datos aparezcan solo tras 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 y Auto admiten todos los métodos. Browser ignora el método (Chrome siempre emite GET para la navegación) y el body.

Pestañas de la request

Debajo de la fila de 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 Cuerpo de formato libre para requests POST / PUT / PATCH
Headers Headers de request personalizados como pares clave-valor
Cookies Un cookie jar guardado por host en este navegador. Use jar adjunta las cookies coincidentes al request y Save response cookies almacena las que define una response. Ambas opciones están activadas por defecto, y la pestaña muestra una vista previa de lo que enviará este request
Raw El payload JSON exacto que se enviará, como una vista previa de solo lectura con Copy JSON, y el comando curl para reproducirlo debajo

Cualquier cambio que hagas en UI / Body / Headers / Cookies se refleja en Raw. No puedes escribir en Raw: modifica el request en las otras pestañas. Aparece un punto rojo en cualquier pestaña o sección colapsable que contenga un valor diferente de los valores predeterminados del motor, para que puedas identificar de un vistazo lo que has personalizado.

Secciones del panel de UI

La pestaña UI agrupa la configuración en secciones colapsables. Los campos vacíos recurren al valor predeterminado del esquema del motor. Las secciones que no aplican al Mode actual se ocultan.

  • Timeouts: timeout_ms, connect_timeout_ms, accept_timeout_ms, server_response_timeout_ms, dns_cache_timeout_sec. Browser y Auto exponen únicamente timeout_ms (en Auto, el presupuesto total).
  • Redirects: activa y define followRedirects (0-20). Single y Proxy. Browser sigue las redirecciones por su cuenta.
  • Flags: unblocker para Single, Proxy y Browser (unblocker en Browser completa las validaciones que solicita la página); tryJsonData y returnBuffer para Single y Proxy. Auto expone forceProxy y returnSession en su lugar.
  • Proxy: elige un proxy ID específico para Single o Browser, o define maxTries, el timeout exterior de Proxy, exitCountries, exitClass y ignoreProxies para el motor Proxy. Auto también expone ignoreProxies y exitClass. El selector exitClass tiene tres estados: no establecido no envía ningún campo, standard asigna el pool estándar y premium permite que la request escale a una salida premium cuando el pool estándar tiene dificultades. Tanto sin establecer como standard permanecen en el pool estándar; una request exitosa que especifica una clase recibe exitClass de vuelta. Premium requiere un plan que incluya salidas premium: consulta exitClass.
  • Browser profile: tres menús desplegables en cascada, os, browser y version, que listan lo que FourA puede presentar realmente. Aparecen en los modos Single y Proxy. Déjalos vacíos para usar el Chrome más reciente. Cada selector restringe a los otros dos, por lo que nunca aparece una combinación que no resuelva nada. La sección necesita unblocker activado: si está desactivado no se envían headers de navegador, el perfil solo se aplicaría a medias y, en su lugar, la API rechazará la request.
  • Browser: opciones exclusivas de navegador como checkStatus y checkText.
  • Validate: status accept y status fail aceptan códigos de estado separados por comas (validate.status), y body accept y body fail aceptan subcadenas con alternativas separadas por | (validate.data). Disponible para Single, Proxy y Auto. Browser usa checkStatus y checkText en su lugar. El formulario no tiene campo para reglas de headers (validate.headers).

Una vez que una ejecución devuelve un proxy que funcionó, aparece una sección Working proxies al final de la pestaña de la interfaz. Muestra hasta 20 proxy IDs, los más recientes primero, cada uno con su país de salida y hora. use coloca uno en el campo proxy en Single o Browser (el motor Proxy busca el suyo propio) y × lo elimina de la lista.

Alcance del país de salida (modo Proxy)

El campo exitCountries en Proxy acepta una lista separada por comas de códigos de país de dos letras visibles para el destino (CZ, GB). Los valores se limpian de espacios, se convierten a mayúsculas y se deduplican al enviar. La selección del pool estándar es una lista de permisos estricta: los proxies con salidas desconocidas se excluyen y el pool nunca recurre a otro país. Una salida premium también sigue la lista. Con exitClass configurado en premium, una salida premium sale desde uno de los países listados, y un país donde el pool estándar no tiene disponibilidad recurre a salidas premium allí. Sin premium, un pool sin coincidencias devuelve code: "no_eligible_proxy" con el scope solicitado reflejado en details.exitCountries. Conserva el scope y vuelve a intentarlo más tarde.

Cuando una llamada de proxy tiene éxito bajo scoping, la franja de respuesta muestra exit <CODE> junto al ID del proxy para que puedas verificar que el país servido coincida con lo que solicitaste.

Ubicación de salida (Modo Proxy)

El grupo Exit location en Proxy elige desde dónde sale una salida premium: región, ciudad, red, dispositivo y cuánto tiempo mantiene su dirección. Las listas de región, ciudad y red se completan cuando exitCountries nombra exactamente un país. Configura exitClass en premium, ya que cualquiera de estas opciones envía la request solo a través de salidas premium. El ID del proxy en la respuesta conserva el lugar, por lo que llevarlo a Single o Browser es todo lo que estos dos necesitan. Consulta Exit location.

Restablecimiento de la barra de herramientas

El botón Reset en la barra de herramientas (junto a History y Saved) restablece el playground a un estado limpio. Como es una acción destructiva, abre un diálogo de confirmación que detalla exactamente lo que se borrará: cada pestaña de request, cualquier cookie guardada en el jar, cualquier proxy transferido y la response actual. Los ajustes preestablecidos guardados y la API key seleccionada se conservan. Haz clic en Reset everything para confirmar; cualquier otra acción cancela.

Envío y cancelación

Haz clic en Send para lanzar la request. La columna derecha cambia a un estado de carga con un spinner y un botón Cancel mientras la llamada está en curso. Haz clic en Cancel (o presiona el botón nuevamente en 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 respuesta cambia al resultado en el momento en que la request finaliza (o falla). En un teléfono, o en cualquier ventana lo suficientemente estrecha como para ubicar la respuesta debajo del formulario, la página desplaza la tarjeta de respuesta a la vista cuando llega abajo en la pantalla. Las ejecuciones en modo Auto pueden tardar más que los motores manuales porque el sistema puede subir varios niveles ante un objetivo frío.

Lectura de la respuesta

La columna de respuesta refleja la estructura de la request con sus propias pestañas:

Pestaña Qué muestra
Body Cuerpo analizado. Cambia entre vistas JSON, HTML y Text según lo devuelto.
Headers Response headers, uno por línea.
Cookies Cookies devueltas por el destino, tanto en vista analizada (agrupada por host) como en bruto (texto Set-Cookie). La vista analizada muestra una insignia HO en las cookies exclusivas de host; las cookies de dominio no están marcadas.
Raw La envoltura JSON completa devuelta por la API.

La barra de herramientas de la respuesta incluye Copy y Download para toda la respuesta, y Find in response (Ctrl+K o Cmd+K) para buscar en la pestaña abierta, con Enter y Shift+Enter para desplazarte por las coincidencias. Body, Headers y Cookies también tienen sus propios Copy y Download exclusivos para esa pestaña.

Una franja de metadatos sobre las pestañas muestra el estado HTTP upstream, el tiempo total, el ID del proxy que gestionó la llamada y (en llamadas con Proxy delimitadas) el código de dos letras exit <CODE>. La franja también muestra el tamaño de la respuesta y, si la API los reporta, los créditos consumidos por la request. En ejecuciones Auto, el nivel y los intentos aparecen en la frase debajo de la franja.

Lo que necesitó la llamada

Una frase debajo de la franja de metadatos detalla textualmente qué ejecutó la página. En una ejecución Auto indica el nivel (una sesión que FourA ya tenía para el host, una request simple, un proxy rotativo, un navegador real o un navegador inicial seguido de una repetición económica), si se resolvió un desafío, cuántos intentos tomó y cuánto costó. Cuando la request configuró exitClass, también indica si la entregó una salida premium o el grupo estándar.

Si uno de los límites de tu plan rechazó la llamada, la frase lo aclara primero: "Stopped by your plan, not by the site", seguido de qué límite fue (requests de navegador agotadas por hoy, demasiadas requests en curso, créditos de este periodo consumidos, etcétera) y un enlace a Usage & Limits. La línea se genera a partir del código X-FourA-Limit devuelto por la API, por lo que ante una página compleja que falla sabrás si la detuvo el sitio o tu plan.

Transferir valores entre ejecuciones

Tras cualquier ejecución que devuelva datos de sesión reutilizables, un pequeño control Carry en la barra de herramientas de la respuesta muestra lo que está disponible:

  • Las ejecuciones Auto realizadas con returnSession ofrecen el userAgent y el proxy de la sesión. Las cookies de la sesión se muestran en la pestaña Cookies de la respuesta y se guardan en el almacén de cookies si Save response cookies está activado.
  • Las ejecuciones Browser ofrecen el userAgent de la respuesta, además del ID del proxy si se utilizó uno.
  • Las ejecuciones Proxy ofrecen el ID del proxy devuelto y el perfil del navegador cuando la rotación eligió uno que no solicitaste.

Haz clic en Carry y selecciona dónde aplicar cada valor en un solo paso: userAgent se convierte en un header User-Agent en Single o Proxy, y el ID del proxy se inserta en el campo proxy en Single o Browser. Los campos que reciben un valor transferido muestran el punto rojo de "modificado" para que puedas ver los cambios.

Un browser profile transferido completa los tres selectores de os, browser y version y activa unblocker, la misma regla que se aplica cuando eliges un perfil manualmente. Solo se ofrece una vez que el catálogo de perfiles ha cargado, ya que el formulario consta de tres selectores y no de un campo de id.

El perfil es el único valor que indica que la request que funcionó no fue la request que escribiste: Proxy reporta profile solo cuando cambió a una familia de navegadores que no solicitaste. Si reproduces sin él, reproduces la versión que falló. Consulta Por qué una Proxy Request se quedó sin intentos.

Expandir a pantalla completa

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

El reproductor de curl

En la pestaña Raw de la request, debajo del JSON, un bloque de curl muestra el comando exacto de línea de comandos equivalente a la request que estás creando, con un botón Copy curl. Cópialo para reproducir la request desde una terminal, compartirlo con un compañero de equipo o pegarlo en un reporte de error.

Para las claves que se pueden revelar, un botón Reveal key junto al fragmento inserta la clave real en texto sin formato directamente en el curl para que puedas copiar y ejecutar tal cual. Haz clic de nuevo para ocultarla. Las claves heredadas (creadas antes de lanzar la función de revelación) mantienen un marcador de posición PASTE_PLAINTEXT_FOR_<key-name>; regenera la clave desde la página API Keys para que se pueda revelar.

La revelación se registra en el log de auditoría del servidor cada vez, y la clave en texto sin formato solo permanece en memoria durante la sesión actual de la página.

Guardar presets

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

Abre Saved en la barra de herramientas para ver tus presets. Haz clic en Load para completar el formulario o en Delete para eliminar uno.

Una request abierta desde la pestaña DevTools de la extensión FourA Chrome se carga con la clave de la extensión seleccionada cuando esa clave está en tu cuenta, y la página así lo indica. De lo contrario, te pide que elijas una clave. Una request reproducida que no define unblocker se ejecuta con él activado, como lo hace la API.

Campo del preset Qué almacena
Name Una etiqueta corta (hasta 100 caracteres)
Description Notas opcionales (hasta 500 caracteres)
Endpoint Para qué motor es el preset (auto / single / proxy / browser)
Config El payload completo de la request, incluidos 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.

Reproducir desde el historial

Cada request que ejecutas queda registrada. Abre History en la barra de herramientas para ver tus últimas 20 ejecuciones, ordenadas de más reciente a 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 en Send para ejecutarla de nuevo.

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

Abrir desde Activity

El cuadro de diálogo de detalles de Activity Log tiene un botón Open in Playground. Haz clic en él y el Playground se cargará con la request archivada y 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 insignia "archived" en la franja de metadatos del proxy ("archived

Desde allí puedes cambiar un parámetro y pulsar 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 más antiguas de Activity no tendrán una response recargable.

Consejos

  • Empieza en Playground antes de escribir código para un nuevo destino. Con Auto activado, sabrás en segundos si basta con un fetch económico o si el sitio obliga a una resolución por navegador.
  • Para destinos bloqueados por país, ejecuta una llamada Proxy con exitCountries configurado, luego traslada el proxy ID devuelto a una llamada Browser para que el renderizado de JavaScript se realice a través de la misma salida.
  • Guarda un preset para cada destino del que hagas scraping periódicamente. Reproducir un preset guardado requiere un solo clic; reconstruir la request de memoria lleva más tiempo.
  • Usa la pestaña Cookies para depurar el scraping basado en sesiones. La vista de Set-Cookie en bruto muestra exactamente lo que envió el destino.
  • Cuando un destino te rechace, prueba con otra entrada en la selección de perfiles de Browser antes de recurrir a un motor más pesado. Cambiar el navegador presentado es gratuito; un renderizado de navegador no lo es.
  • Las requests de Playground se facturan con cargo a la key que elijas. Usa una key dedicada con cuota baja para exploraciones casuales si quieres mantener limpio el uso de producción.
  • API Endpoints: Referencia completa de parámetros para los cuatro motores, incluidos exitCountries y los campos de perfil del navegador
  • Smart Fetch (Auto): Qué hace Auto internamente
  • Choosing the Right Endpoint: Cuándo elegir Auto frente a Single frente a Proxy frente a Browser
  • API Keys: Gestiona las keys con las que autenticas las requests de Playground
  • Activity Log: Abre una request anterior directamente en Playground
  • Dashboard Overview: Todas las secciones de la barra lateral
Actualizado: 11 de noviembre de 2026