Docs › Dashboard › Créer une tâche

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 tableau de bord FourA.

Étape 1 : Ouvrir le tableau de bord

Accédez au tableau de bord et connectez-vous avec votre compte FourA.

Étape 2 : Créer une clé API

Allez sur la page Clés API et cliquez sur Créer une clé.

Donnez à la clé un nom descriptif (par exemple, "production-scraper" ou "dev-testing"). La boîte de dialogue de confirmation affiche la clé en clair avec un bouton de copie.

Si vous la manquez, cliquez plus tard sur l'icône en forme d'œil sur la ligne de la clé pour la révéler à nouveau. Les anciennes clés créées avant l'ajout de cette fonctionnalité ne peuvent pas être récupérées (générez-les à nouveau une fois pour faire la transition). Flux complet : Gestion des clés API.

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/)

Le choix par défaut intelligent. Transmettez une URL et une règle validate, et FourA choisit le chemin le moins cher qui fonctionne : requête directe, proxy rotatif ou navigateur complet. Idéal lorsque vous ciblez un nouveau site et que vous ne savez pas encore ce dont il a besoin.

Single (POST /api/single/)

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

Browser (POST /api/browser/)

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

Proxy (POST /api/proxy/)

Achemine la requête via des proxys rotatifs avec nouvelle tentative automatique. Idéal pour les sites dotés d'une détection de bots ou d'un contenu géo-restreint.

É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 possède un result avec la ligne de statut et chaque header de réponse renvoyé par la cible.

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 6 : Essayer une requête de navigateur

Si la page cible utilise JavaScript pour rendre le contenu, utilisez plutôt l'endpoint du 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 courants

Problème Solution
Vous ne savez pas quel moteur utiliser Commencez par 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 un rendu JS
CAPTCHA dans la réponse Passez à l'endpoint proxy pour une rotation automatique des IP
Délai d'attente dépassé 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 Clés API pour la révéler, ou générez-la à nouveau s'il s'agit d'une ancienne clé

Étapes suivantes

Mis à jour : 8 juillet 2026
← Aperçu du tableau de bord Gérer les clés API →