Tu primer request
Esta guía te explica cómo crear una API key y enviar tu primer request usando el Dashboard de FourA.
Paso 1: Abrir el Dashboard
Navega al Dashboard e inicia sesión con tu cuenta de FourA.
Paso 2: Crear una API Key
Ve a la página de API Keys y haz clic en Create Key.
Asigna un nombre descriptivo a la clave (por ejemplo, "production-scraper" o "dev-testing"). La clave completa solo se muestra una vez, así que cópiala de inmediato.
Tu clave se verá así: pk_live_a1b2c3d4e5f6...
Paso 3: Elegir un endpoint
FourA tiene tres endpoints para diferentes escenarios:
Single (POST /api/single/)
Envía un request HTTP rápido. Ideal para páginas HTML estáticas y endpoints de API. Tiempo de response: normalmente menos de 2 segundos.
Browser (POST /api/browser/)
Ejecuta una instancia del navegador Chrome para renderizar JavaScript. Ideal para SPAs, contenido con carga diferida (lazy-loaded) y páginas que requieren la ejecución de JS. Tiempo de response: de 2 a 10 segundos.
Proxy (POST /api/proxy/)
Enruta el request a través de proxies rotativos con reintento automático. Ideal para sitios con detección de bots o contenido con restricción geográfica.
Paso 4: Enviar tu primer 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: Leer la response
{
"status": 200,
"headers": [["content-type", "text/html"]],
"data": "<html>...</html>",
"total_time": 0.45
}
Campos clave:
- status: código de estado HTTP del sitio de destino
- data: el cuerpo de la response (HTML, JSON o texto sin formato)
- total_time: duración del request en segundos
Paso 6: Probar un request de Browser
Si la página de destino utiliza JavaScript para renderizar el contenido, usa el endpoint de browser 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 browser utiliza body en lugar de data:
{
"status": 200,
"headers": {"content-type": "text/html"},
"body": "<html>...</html>"
}
Problemas comunes
| Problema | Solución |
|---|---|
| Contenido vacío | Cambia del endpoint single al de browser: es probable que la página necesite renderizado de JS |
| Captcha en la response | Cambia al endpoint de proxy para la rotación automática de IP |
| Timeout | Aumenta timeout_ms o verifica que la URL sea correcta |
Siguientes pasos
- Vista general del Dashboard: Recorrido completo por el dashboard
- Playground: Prueba requests en el dashboard antes de escribir código
- Cómo elegir el endpoint adecuado: Comparación detallada
- Problemas comunes: Resuelve problemas rápidamente