Docs › Démarrage › Démarrage rapide

Démarrage rapide

Passez de zéro à votre première collecte de données en moins de deux minutes.

Prérequis

Étape 1 : Obtenez 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 requête.

Étape 2 : Faites votre première requête

Ouvrez un terminal et exécutez ceci (remplacez YOUR_API_KEY par votre véritable clé) :

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 requête HTTP à example.com et retourne le HTML de la page.

Étape 3 : Lisez la réponse

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

Le champ headers est un tableau d'objets, un par saut de redirection. Chaque entrée possède un champ result avec la ligne de statut ainsi que chaque header de réponse que la cible a retourné pour ce saut.

Champs clés :

  • status : code de statut HTTP du site cible
  • data : le corps de la réponse (HTML, JSON ou texte brut)
  • total_time : durée de la requête en secondes

Étape 4 : Essayez différents endpoints

FourA dispose de quatre endpoints pour différentes situations :

Endpoint Vitesse Quand l'utiliser
POST /api/auto/ Variable (rapide sur les hôtes chauds) Vous ne savez pas de quel moteur le site a besoin. Passez une URL et laissez FourA choisir le chemin le moins cher qui fonctionne.
POST /api/single/ Le plus rapide (200ms-2s) Pages statiques, APIs, sites rendus côté serveur
POST /api/browser/ Moyenne (2s-10s) Pages chargées en JavaScript, SPAs, contenu dynamique
POST /api/proxy/ Rapide (1s-5s) Sites avec détection de bots, contenu géo-restreint

Essayez une requête auto (le choix par défaut intelligent) :

curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'

Essayez une requête 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", "timeout_ms": 15000}'

Essayez une requête proxy (rotation de proxy automatique) :

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
    }
  }'

Prochaines étapes

Mis à jour : 1 juillet 2026
Authentification →