Votre premier request
Ce guide vous explique comment créer une clé API et envoyer votre premier request à l'aide du Dashboard FourA.
Étape 1 : Ouvrir le Dashboard
Accédez au Dashboard et connectez-vous avec votre compte FourA.
Étape 2 : Créer une clé API
Allez sur la page API Keys et cliquez sur Create Key.
Donnez à la clé un nom descriptif (par exemple, "production-scraper" ou "dev-testing"). La clé complète ne s'affiche qu'une seule fois, copiez-la donc immédiatement.
Votre clé ressemble à ceci : pk_live_a1b2c3d4e5f6...
Étape 3 : Choisir un endpoint
FourA propose trois endpoints pour différents scénarios :
Single (POST /api/single/)
Envoie un request HTTP rapide. Idéal pour les pages HTML statiques et les endpoints API. Temps de response : généralement moins de 2 secondes.
Browser (POST /api/browser/)
Exécute une instance de navigateur Chrome pour charger le JavaScript. Idéal pour les SPA, le contenu chargé en différé et les pages nécessitant l'exécution de JS. Temps de response : 2 à 10 secondes.
Proxy (POST /api/proxy/)
Achemine le request via des proxies tournants avec tentative automatique. Idéal pour les sites avec détection de bots ou contenu géo-bloqué.
Étape 4 : Envoyer votre premier request
Ouvrez un terminal et exécutez :
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"}'
Étape 5 : Lire la response
{
"status": 200,
"headers": [["content-type", "text/html"]],
"data": "<html>...</html>",
"total_time": 0.45
}
Champs clés :
- status : code de statut HTTP du site cible
- data : le corps de la response (HTML, JSON ou texte brut)
- total_time : durée du request en secondes
Étape 6 : Essayer un request Browser
Si la page cible utilise JavaScript pour charger le contenu, utilisez plutôt l'endpoint browser :
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 du browser utilise body au lieu de data :
{
"status": 200,
"headers": {"content-type": "text/html"},
"body": "<html>...</html>"
}
Problèmes courants
| Problème | Solution |
|---|---|
| Contenu vide | Passez de l'endpoint single à l'endpoint browser : la page nécessite probablement un rendu JS |
| CAPTCHA dans la response | Passez à l'endpoint proxy pour une rotation automatique des IP |
| Timeout | Augmentez timeout_ms ou vérifiez que l'URL est correcte |
Étapes suivantes
- Présentation du Dashboard : Présentation complète du Dashboard
- Playground : Testez les requests dans le Dashboard avant d'écrire du code
- Choisir le bon endpoint : Comparaison détaillée
- Problèmes courants : Résolvez les problèmes rapidement