Guide de démarrage rapide
Passez de zéro à votre première collecte de données en moins de deux minutes.
Prérequis
- Un compte FourA (inscrivez-vous ici)
- Votre clé API (créez-en une dans le Dashboard)
Étape 1 : Obtenir votre clé API
Connectez-vous au Dashboard et créez une clé API. Elle ressemble à ceci : pk_live_a1b2c3d4e5f6...
Copiez-la. Vous en aurez besoin pour chaque request.
Étape 2 : Effectuer votre première request
Ouvrez un terminal et exécutez ceci (remplacez YOUR_API_KEY par votre clé réelle) :
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"}'
Cela envoie une request HTTP à example.com et renvoie l'HTML de la page.
Étape 3 : Lire la response
{
"status": 200,
"headers": [["content-type", "text/html"]],
"data": "<!doctype html><html>...</html>",
"total_time": 0.45
}
Champs clés :
status: code de statut HTTP du site cibledata: le corps de la response (HTML, JSON ou texte brut)total_time: durée de la request en secondes
Étape 4 : Essayer différents endpoints
FourA dispose de trois endpoints pour différentes situations :
| Endpoint | Rapidité | Quand l'utiliser |
|---|---|---|
POST /api/single/ |
Le plus rapide (200 ms-2 s) | Pages statiques, APIs, sites générés côté serveur |
POST /api/browser/ |
Moyen (2 s-10 s) | Pages riches en JavaScript, SPAs, contenu dynamique |
POST /api/proxy/ |
Rapide (1 s-5 s) | Sites avec détection de bots, contenu géo-restreint |
Try a browser request:
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", "timeout_ms": 15000}'
Essayez une request proxy (rotation automatique de proxy) :
curl -X POST https://eu.api.foura.ai/api/proxy/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"maxTries": 3,
"request": {
"method": "GET",
"url": "https://example.com",
"unblocker": true
}
}'
Étapes suivantes
- Authentification : gestion et sécurité des clés API
- Endpoints API : référence complète des paramètres pour les trois endpoints
- SDKs et bibliothèques : exemples en Python, Node.js, Go, Ruby
- Choisir le bon endpoint : quand utiliser single vs. browser vs. proxy