Créer une tâche

Ce guide vous accompagne pour créer une clé API et envoyer votre première 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

Accédez à la page API Keys et cliquez sur Create API key. Dès que vous possédez une clé, le bouton situé au-dessus de la liste indique Create Key.

Attribuez un nom descriptif à la clé (par exemple, "production-scraper" ou "dev-testing"). La boîte de dialogue API Key Created affiche la clé en clair avec un bouton de copie, et sous Test your first request, une commande curl prête à l'emploi avec Copy command. Sur téléphone ou tablette, Try it in the Playground vous y redirige directement.

Si vous l'avez manquée, cliquez plus tard sur l'icône en forme d'œil sur la ligne de la clé pour l'afficher à nouveau. Les anciennes clés créées avant le déploiement de cette fonctionnalité ne peuvent pas être réaffichées ; régénérez-les une fois pour basculer. Parcours complet : Managing API Keys.

Votre clé ressemble à ceci : pk_live_a1b2c3d4e5f6...

Étape 3 : Choisir un endpoint

FourA propose quatre endpoints adaptés à différents scénarios :

Auto (POST /api/auto/)

L'option par défaut intelligente. Transmettez une URL, idéalement avec une règle validate, et FourA progresse par étapes d'un proxy rotatif vers un navigateur complet via proxy, s'arrêtant dès la première réponse valide. Définissez forceProxy: false pour tester d'abord une request directe. Idéal lorsque vous ciblez un nouveau site sans connaître ses exigences.

Single (POST /api/single/)

Envoie une request HTTP rapide. Idéal pour les pages HTML statiques et les endpoints API. Temps de réponse : généralement inférieur à 2 secondes.

Browser (POST /api/browser/)

Exécute une instance de navigateur Chrome pour le rendu JavaScript. Idéal pour les SPA, le contenu chargé dynamiquement et les pages nécessitant l'exécution de code JS. Temps de réponse : 2 à 10 secondes.

Proxy (POST /api/proxy/)

Achemine la request via des proxys rotatifs avec nouvelle tentative automatique. Idéal pour les sites qui contrôlent l'origine des requêtes ou renvoient des réponses différentes selon le pays.

Étape 4 : Envoyer votre première 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 réponse

{
  "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
}

Le champ headers est un tableau d'objets, un par saut de redirection. Chaque entrée contient un champ result avec la ligne de statut ainsi que chaque header de réponse renvoyé par la cible.

Champs clés :

  • status : code de statut HTTP provenant 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 6 : Essayer une requête par navigateur

Si la page cible utilise JavaScript pour afficher son contenu, utilisez plutôt l'endpoint de navigateur :

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 réponse du navigateur utilise body au lieu de data :

{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}

Problèmes fréquents

Problème Solution
Quel moteur choisir Commencez avec l'endpoint auto. Il choisit le bon chemin et mémorise ce qui a fonctionné.
Contenu vide Passez de l'endpoint single à l'endpoint browser: la page nécessite probablement le rendu JS
Page de vérification dans la response Passez à l'endpoint proxy pour une rotation automatique d'IP
Timeout Augmentez timeout_ms ou vérifiez que l'URL est correcte
Clé perdue Cliquez sur l'icône en forme d'œil sur la ligne de la clé dans API Keys pour l'afficher, ou régénérez-la s'il s'agit d'une ancienne clé

Prochaines étapes

Mis à jour : 28 octobre 2026