Créer une tâche

Ce guide vous explique comment créer une clé API et envoyer votre première requête à 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 API key. Une fois que vous possédez une clé, le bouton situé au-dessus de la liste affiche Create Key.

Donnez à la clé un nom descriptif (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 un téléphone ou une tablette, Try it in the Playground vous y redirige à la place.

Si vous la manquez, 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. Processus complet : Managing API Keys.

Votre clé ressemble à ceci : pk_live_a1b2c3d4e5f6...

Étape 3 : Choisir un endpoint

FourA propose quatre endpoints pour différents scénarios :

Auto (POST /api/auto/)

L'option intelligente par défaut. Fournissez une URL ainsi qu'une règle validate et FourA choisit la méthode la plus économique et efficace : requête directe, proxy rotatif ou navigateur complet. Idéal lorsque vous ciblez un nouveau site et ne connaissez pas encore ses exigences.

Single (POST /api/single/)

Envoie une requête 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 du navigateur Chrome pour effectuer le rendu JavaScript. Idéal pour les SPA, le contenu chargé à la demande (lazy-loaded) et les pages nécessitant l'exécution de JS. Temps de réponse : 2 à 10 secondes.

Proxy (POST /api/proxy/)

Achemine la requête via des proxys rotatifs avec nouvelle tentative automatique. Idéal pour les sites qui vérifient l'émetteur de la requête ou dont les réponses varient selon le pays.

Étape 4 : Envoyer votre première requête

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 result avec la ligne de statut ainsi que chaque header de réponse renvoyé par la cible.

Champs principaux :

• 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

Étapes suivantes

• Présentation du Dashboard: Visite guidée complète du dashboard
• Playground: Testez les requêtes dans le dashboard avant d'écrire du code
• Smart Fetch (Auto): Présentation détaillée de l'endpoint auto
• Choisir le bon endpoint: Comparaison détaillée
• Problèmes fréquents: Résolvez rapidement les problèmes