# Créer une tâche

> URL: https://foura.ai/fr/docs/dashboard/creating-a-task
> Updated: 2026-10-28
> Index: https://foura.ai/llms.txt

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](https://foura.ai/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](https://foura.ai/docs/dashboard/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 :

```bash
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

```json
{
  "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 :

```bash
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` :

```json
{
  "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

- [Vue d'ensemble du Dashboard](https://foura.ai/docs/dashboard/overview): Présentation complète du dashboard
- [Playground](https://foura.ai/docs/dashboard/playground): Testez les requêtes dans le dashboard avant d'écrire du code
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Guide détaillé sur l'endpoint auto
- [Choisir le bon endpoint](https://foura.ai/docs/guides/choosing-task-type): Comparaison détaillée
- [Problèmes fréquents](https://foura.ai/docs/troubleshooting/common-issues): Résolvez rapidement les anomalies
