Crear una tarea
Esta guía te orienta para crear una API key y enviar tu primera request usando el Dashboard de FourA.
Paso 1: Abre el Dashboard
Ve al Dashboard e inicia sesión con tu cuenta de FourA.
Paso 2: Crea una API Key
Ve a la página API Keys y haz clic en Create API key. Una vez que tengas una clave, el botón encima de la lista mostrará Create Key.
Asigna a la clave un nombre descriptivo (por ejemplo, "production-scraper" o "dev-testing"). El diálogo API Key Created muestra la clave sin procesar con un botón para copiar, y bajo Test your first request, un comando curl listo para ejecutar con Copy command. En un teléfono o tablet, Try it in the Playground te llevará allí directamente.
Si no lo copiaste, haz clic en el icono del ojo en la fila de la clave para volver a mostrarla más tarde. Las claves heredadas creadas antes del lanzamiento de esta función no se pueden recuperar; vuelve a generarlas una vez para actualizarlas. Flujo completo: Managing API Keys.
Tu clave se ve así: pk_live_a1b2c3d4e5f6...
Paso 3: Elige un Endpoint
FourA cuenta con cuatro endpoints para diferentes escenarios:
Auto (POST /api/auto/)
La opción inteligente por defecto. Envía una URL, idealmente con una regla validate, y FourA escala progresivamente desde un proxy rotativo hasta un navegador completo a través de proxy, deteniéndose en la primera respuesta válida. Define forceProxy: false para que intente una request directa primero. Es ideal cuando trabajas con un sitio nuevo y aún no sabes qué necesita.
Single (POST /api/single/)
Envía una HTTP request rápida. Ideal para páginas HTML estáticas y endpoints de API. Tiempo de response: típicamente menos de 2 segundos.
Browser (POST /api/browser/)
Ejecuta una instancia de navegador Chrome para renderizar JavaScript. Ideal para SPAs, contenido con carga diferida (lazy load) y páginas que requieren ejecución de JS. Tiempo de response: de 2 a 10 segundos.
Proxy (POST /api/proxy/)
Enruta la request a través de proxies rotativos con reintento automático. Ideal para sitios que verifican el origen de la conexión o que responden de forma distinta según el país.
Paso 4: Envía tu primera request
Abre una terminal y ejecuta:
curl -X POST https://eu.api.foura.ai/api/single/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"method": "GET", "url": "https://example.com"}'
Paso 5: Lee la response
{
"status": 200,
"headers": [
{
"result": { "version": "HTTP/2", "code": 200, "reason": "" },
"content-type": "text/html; charset=UTF-8",
"content-length": "1256"
}
],
"data": "<html>...</html>",
"total_time": 0.45
}
El campo headers es un array de objetos, uno por cada salto de redirección. Cada entrada tiene un result con la línea de estado más cada header de respuesta que devolvió el destino.
Campos clave:
- status: código de estado HTTP del sitio de destino
- data: el cuerpo de la respuesta (HTML, JSON o texto sin formato)
- total_time: duración de la request en segundos
Paso 6: Prueba una request con navegador
Si la página de destino usa JavaScript para renderizar contenido, usa el endpoint de navegador en su lugar:
curl -X POST https://eu.api.foura.ai/api/browser/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/products", "timeout_ms": 15000}'
La response del navegador utiliza body en lugar de data:
{
"status": 200,
"headers": {"content-type": "text/html"},
"body": "<html>...</html>"
}
Problemas comunes
| Problema | Solución |
|---|---|
| No estás seguro de qué motor usar | Empieza con el endpoint auto. Elige la ruta adecuada y recuerda lo que funcionó. |
| Contenido vacío | Cambia del endpoint single al browser: es probable que la página requiera renderizado de JS |
| Página de verificación en la respuesta | Cambia al endpoint proxy para la rotación automática de IP |
| Timeout | Aumenta timeout_ms o verifica que la URL sea correcta |
| Perdiste tu clave | Haz clic en el icono del ojo en la fila de la clave en API Keys para mostrarla, o regenera si la clave es legacy |
Pasos siguientes
- Vista general del Dashboard: Recorrido completo por el dashboard
- Playground: Prueba requests en el dashboard antes de escribir código
- Smart Fetch (Auto): Análisis detallado del endpoint auto
- Elegir el endpoint correcto: Comparación detallada
- Problemas comunes: Resuelve problemas rápidamente