# Playground

> URL: https://foura.ai/fr/docs/dashboard/playground
> Updated: 2026-11-11
> Index: https://foura.ai/llms.txt

Le Playground (barre latérale > Playground) vous permet d'exécuter des requêtes API en direct avec votre véritable clé sans écrire de code. C'est le moyen le plus rapide de tester un nouveau site cible, de déboguer une réponse complexe ou de comparer Auto, Single, Proxy et Browser côte à côte.

Ouvrez-le sur [foura.ai/dashboard#playground](https://foura.ai/dashboard#playground).

## Ce qu'il fait

Un formulaire. Quatre moteurs. Du trafic réel.

- **Auto** : récupération intelligente. Vous transmettez une URL ainsi qu'une règle `validate` et FourA choisit le chemin le plus économique qui fonctionne.
- **Single** : récupération HTTP directe avec des caractéristiques réseau réalistes de type navigateur
- **Proxy** : récupération via un proxy tournant géré, avec ciblage géographique optionnel selon le pays visible par la cible
- **Browser** : ouvre l'URL dans une instance de navigateur Chrome pour les sites avec rendu JS

Les requêtes s'exécutent avec la clé API que vous sélectionnez en haut de la page. L'utilisation est décomptée du quota de cette clé exactement comme un appel en production, veillez donc à ne pas épuiser votre forfait lors de vos tests.

## Choisir une clé

Le menu déroulant des clés API liste toutes les clés actives que vous pouvez utiliser : les vôtres sous **My Keys**, puis un groupe par organisation à laquelle vous appartenez. Tout membre peut exécuter la clé d'une organisation, et une requête sur celle-ci est décomptée du forfait du propriétaire de l'organisation. Choisissez celle sur laquelle vous souhaitez facturer la requête. Si vous n'avez pas encore de clé active, un message intégré vous renvoie vers la page **API Keys** pour en créer une.

## Choisir un mode

Une ligne supérieure **Mode** permet de basculer entre **Auto** et les moteurs manuels. Lorsque Auto est sélectionné, le formulaire bascule vers l'interface minimale d'Auto (URL plus `validate` et quelques options). Les deux lignes sont toujours affichées : **Mode :** Auto, et **Endpoint :** **Single**, **Proxy**, **Browser**. En sélectionner un désélectionne l'autre. Changer d'endpoint modifie les champs visibles ainsi que le moteur interrogé par la requête. La sélection actuelle est conservée lorsque vous rechargez la page.

| Mode | Quand l'utiliser |
|------|----------------|
| Auto | Nouvelle cible ou site avec protections mixtes. Auto choisit le chemin le plus économique et mémorise ce qui fonctionne. |
| Single | Récupération HTTP rapide. Meilleur premier choix pour un hôte connu. |
| Proxy | Même récupération avec rotation automatique de proxy. Définissez `exitCountries` lorsque vous avez besoin d'un pays visible par la cible. |
| Browser | Charge la page dans une instance de navigateur Chrome. À utiliser lorsque les données n'apparaissent qu'après l'exécution de JavaScript. |

## Construire la requête

### Ligne d'URL

La ligne supérieure contient la méthode HTTP (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS), l'URL cible et le bouton **Send**. Single, Proxy et Auto acceptent toutes les méthodes. Browser ignore la méthode (Chrome émet toujours un GET pour la navigation) ainsi que le corps de la requête.

### Onglets de requête

Sous la ligne d'URL, cinq onglets vous permettent de renseigner tout le reste :

| Onglet | Ce qu'il controle |
|-----|------------------|
| UI | Champs de formulaire pour les timeouts, redirections, flags, proxy, options specifiques au navigateur et regles de validation |
| Body | Corps libre pour les requetes POST / PUT / PATCH |
| Headers | Headers de requete personnalises sous forme de paires cle-valeur |
| Cookies | Un cookie jar conserve par hote dans ce navigateur. **Use jar** associe les cookies correspondants a la requete et **Save response cookies** enregistre ceux definis par une reponse. Les deux sont actives par defaut, et l'onglet affiche un apercu de ce que cette requete enverra |
| Raw | Le payload JSON exact qui sera envoye, sous forme d'apercu en lecture seule avec **Copy JSON**, ainsi que la commande curl de reproduction juste en dessous |

Toute modification apportee dans UI / Body / Headers / Cookies se reflete dans Raw. Vous ne pouvez pas ecrire directement dans Raw : modifiez la requete sur les autres onglets. Un point rouge apparait sur tout onglet ou section repliable contenant une valeur differente des valeurs par defaut du moteur, ce qui vous permet d'identifier d'un coup d'oeil vos personnalisations.

### Sections du volet UI

L'onglet UI regroupe les parametres dans des sections repliables. Les champs vides reprennent la valeur par defaut du schema du moteur. Les sections qui ne s'appliquent pas au Mode actuel sont masquees.

- **Timeouts** : `timeout_ms`, `connect_timeout_ms`, `accept_timeout_ms`, `server_response_timeout_ms`, `dns_cache_timeout_sec`. Browser et Auto exposent uniquement `timeout_ms` (sur Auto, le budget total).
- **Redirections** : activez et définissez `followRedirects` (0-20). Single et Proxy. Browser suit les redirections de manière autonome.
- **Flags** : `unblocker` pour Single, Proxy et Browser (`unblocker` sur Browser complète les vérifications demandées par une page) ; `tryJsonData` et `returnBuffer` pour Single et Proxy. Auto expose `forceProxy` et `returnSession` à la place.
- **Proxy** : choisissez un identifiant proxy spécifique pour Single ou Browser, ou définissez `maxTries`, le timeout externe du Proxy, `exitCountries`, `exitClass` et `ignoreProxies` pour le moteur Proxy. Auto expose également `ignoreProxies` et `exitClass`. Le sélecteur `exitClass` a trois états : non défini n'envoie aucun champ, `standard` désigne le pool standard, et `premium` permet à la requête de basculer vers une sortie premium lorsque le pool standard rencontre des difficultés. Non défini et `standard` restent tous deux sur le pool standard ; une requête réussie qui spécifie une classe reçoit `exitClass` en retour. Le mode premium nécessite un forfait incluant les sorties premium : voir [exitClass](https://foura.ai/docs/api/endpoints#exitclass).
- **Profil de navigateur** : trois menus déroulants en cascade, **os**, **browser** et **version**, listant ce que FourA peut réellement présenter. Ils apparaissent en mode Single et Proxy. Laissez-les vides pour la version de Chrome la plus récente. Chaque sélection affine les deux autres, évitant ainsi toute combinaison sans résultat. Cette section nécessite l'activation de `unblocker` : si cette option est désactivée, aucun header de navigateur n'est envoyé, le profil ne s'appliquerait qu'à moitié, et l'API rejette alors la requête.
- **Browser** : options spécifiques au navigateur telles que `checkStatus` et `checkText`.
- **Validation** : **status accept** et **status fail** prennent des codes de statut séparés par des virgules (`validate.status`), et **body accept** et **body fail** prennent des sous-chaînes avec des alternatives séparées par `|` (`validate.data`). Disponible pour Single, Proxy et Auto. Browser utilise `checkStatus` et `checkText` à la place. Le formulaire ne comporte aucun champ pour les règles d'en-tête (`validate.headers`).

Dès qu'une exécution renvoie un proxy fonctionnel, une section **Working proxies** apparaît à la fin de l'onglet de l'interface. Elle liste jusqu'à 20 identifiants de proxy, les plus récents en premier, chacun avec son pays de sortie et son horodatage. **use** en insère un dans le champ `proxy` pour Single ou Browser (le moteur Proxy trouve le sien de façon autonome), et **×** le supprime de la liste.

### Définition du pays de sortie (Mode Proxy)

Le champ **exitCountries** de Proxy accepte une liste de codes pays à deux lettres séparés par des virgules (`CZ, GB`). Les valeurs sont nettoyées des espaces, converties en majuscules et dédupliquées lors de la soumission. La sélection dans le pool standard applique une liste d'autorisation stricte : les proxys dont les sorties sont inconnues sont exclus et le pool ne bascule jamais vers un autre pays. Une sortie premium respecte également cette liste. Lorsque **exitClass** est défini sur `premium`, une sortie premium provient de l'un des pays listés, et un pays absent du pool standard est redirigé vers des sorties premium de cette zone. Sans `premium`, un pool sans correspondance renvoie `code: "no_eligible_proxy"` avec le périmètre demandé répété dans `details.exitCountries`. Conservez le périmètre et réessayez ultérieurement.

Lorsqu'un appel proxy réussit dans le cadre d'un périmètre défini, le bandeau de réponse affiche `exit <CODE>` à côté de l'ID de proxy afin que vous puissiez vérifier que le pays servi correspond à votre demande.

### Emplacement de sortie (mode Proxy)

Le groupe **Exit location** de Proxy définit la provenance d'une sortie premium : région, ville, réseau, appareil et durée de conservation de son adresse. Les listes de régions, villes et réseaux se remplissent quand **exitCountries** indique un seul pays. Définissez **exitClass** sur `premium`, car chacune de ces options route la requête exclusivement via des sorties premium. L'ID de proxy dans la réponse conserve cet emplacement, il suffit donc de le reporter dans Single ou Browser pour ces deux modes. Voir [Emplacement de sortie](https://foura.ai/docs/api/endpoints#exit-location).

### Réinitialisation de la barre d'outils

Le bouton **Reset** de la barre d'outils (à côté de **History** et **Saved**) réinitialise le playground. Comme cette action est destructive, elle ouvre une boîte de dialogue de confirmation détaillant précisément les éléments supprimés : chaque onglet de requête, les cookies enregistrés dans le jar, les proxys conservés et la réponse actuelle. Les préréglages enregistrés et la clé API sélectionnée sont conservés. Cliquez sur **Reset everything** pour confirmer; toute autre action annule.

## Envoi et annulation

Cliquez sur **Send** pour lancer la requête. La colonne de droite passe à un état de chargement avec un indicateur d'attente et un bouton **Cancel** pendant que l'appel est en cours. Cliquez sur Cancel (ou appuyez à nouveau sur le bouton sur mobile) pour interrompre. Une requête annulée rétablit le texte de remplacement inactif avec "Request canceled." au lieu d'afficher une erreur.

La carte de réponse affiche le résultat dès que la requête se termine (ou échoue). Sur un téléphone, ou dans toute fenêtre assez étroite pour placer la réponse sous le formulaire, la page fait défiler la carte de réponse jusqu'à l'écran lorsqu'elle arrive plus bas. Les exécutions Auto peuvent prendre plus de temps que les moteurs manuels car le système peut franchir plusieurs étapes sur une cible froide.

## Lecture de la réponse

La colonne de réponse reflète la disposition de la requête avec ses propres onglets :

| Onglet | Contenu affiché |
|-----|---------------|
| Body | Corps analysé. Bascule entre les vues JSON, HTML et Text selon le contenu reçu. |
| Headers | En-têtes de réponse, un par ligne. |
| Cookies | Cookies renvoyés par la cible, en vue analysée (groupée par hôte) et brute (texte Set-Cookie). La vue analysée affiche un badge `HO` sur les cookies host-only ; les cookies de domaine ne comportent aucun marquage. |
| Raw | L'enveloppe JSON complète renvoyée par l'API. |

La barre d'outils de réponse propose les actions **Copy** et **Download** pour l'ensemble de la réponse, ainsi que **Find in response** (Ctrl+K ou Cmd+K) pour effectuer une recherche dans l'onglet ouvert, avec Entrée et Maj+Entrée pour parcourir les correspondances. Body, Headers et Cookies disposent également de leurs propres boutons Copy et Download réservés à leur onglet.

Un bandeau meta au-dessus des onglets affiche le statut HTTP en amont, la durée totale, l'identifiant du proxy ayant traité l'appel, et (pour un appel Proxy ciblé) le code à deux lettres `exit <CODE>`. Ce bandeau indique également la taille de la réponse et, lorsque l'API les communique, les crédits consommés par la requête. Pour les exécutions Auto, le niveau d'escalade et les tentatives figurent dans la phrase située sous le bandeau.

### Ressources nécessaires pour l'appel

Une phrase sous le bandeau meta explique textuellement ce qui a permis de charger la page. Pour une exécution Auto, elle précise le niveau d'escalade (une session que FourA possédait déjà pour l'hôte, une requête simple, un proxy tournant, un véritable navigateur, ou un navigateur suivi d'un rejeu économique), si un challenge a été résolu, le nombre de tentatives nécessaires et son coût. Lorsque la requête définissait `exitClass`, elle indique également si la transmission a été assurée par une sortie premium ou par le pool standard.

Lorsque l'une des limites de votre forfait bloque l'appel, la phrase le signale immédiatement : "Stopped by your plan, not by the site", suivi de la limite concernée (requêtes de navigateur quotidiennes épuisées, trop de requêtes simultanées, crédits de la période consommés, etc.) ainsi qu'un lien vers [Usage & Limits](https://foura.ai/docs/dashboard/quota). Cette ligne est construite à partir du code `X-FourA-Limit` renvoyé par l'API, ce qui vous permet de savoir si l'échec d'une page complexe provient du site ou de votre forfait.

### Reporter des valeurs entre les exécutions

Après toute exécution ayant renvoyé des données de session réutilisables, une commande **Carry** sur la barre d'outils de réponse indique les éléments disponibles :

- Les exécutions **Auto** effectuées avec `returnSession` proposent le `userAgent` et le `proxy` de la session. Les cookies de session s'affichent dans l'onglet **Cookies** de la réponse et s'enregistrent dans le cookie jar lorsque l'option **Save response cookies** est activée.
- Les exécutions **Browser** proposent le `userAgent` de réponse, ainsi que l'identifiant du proxy si un proxy a été utilisé.
- Les exécutions **Proxy** proposent l'identifiant du proxy retourné, ainsi que le profil de navigateur lorsque la rotation en a sélectionné un que vous n'aviez pas demandé.

Cliquez sur **Carry** et choisissez l'emplacement d'application de chaque valeur en un clic : `userAgent` devient un en-tête `User-Agent` sur Single ou Proxy, et l'identifiant du proxy s'insère dans le champ `proxy` sur Single ou Browser. Les champs recevant une valeur reportée affichent le point rouge "modified" afin que vous puissiez repérer les modifications.

Un **profil de navigateur** transféré remplit les trois sélecteurs os, navigateur et version, et active `unblocker`, exactement comme lorsque vous choisissez un profil manuellement. Il n'est proposé qu'une fois le catalogue de profils chargé, puisque le formulaire comporte trois sélecteurs et non un champ d'identifiant.

Le profil est la seule valeur indiquant que la request qui a *fonctionné* n'était pas celle que vous aviez saisie : Proxy signale `profile` uniquement s'il a basculé vers une famille de navigateurs que vous n'aviez pas demandée. Rejouez sans celui-ci et vous rejouerez la version qui a échoué. Consultez [Pourquoi une request de Proxy a épuisé ses tentatives](https://foura.ai/docs/troubleshooting/proxy-attempt-report).

### Passer en plein écran

L'icône d'agrandissement sur la barre d'outils de response extrait la carte de response de la vue fractionnée pour l'afficher dans une superposition plein écran. Utilisez-la pour les arborescences JSON profondes, les longs dumps Set-Cookie ou les corps HTML larges lorsque la colonne demi-largeur devient trop étroite. La page elle-même cesse de défiler tant que la superposition est ouverte. Cliquez à nouveau sur l'icône (ou appuyez sur Échap) pour réduire.

## Le reproducteur cURL

Dans l'onglet **Raw** de la request, sous le JSON, un bloc cURL affiche la commande équivalente exacte de la request que vous construisez, avec un bouton **Copier cURL**. Copiez-le pour reproduire la request depuis un terminal, la partager avec un collègue ou la coller dans un rapport de bug.

Pour les clés affichables, un bouton **Afficher la clé** à côté de l'extrait insère directement la vraie clé en texte clair dans le cURL afin que vous puissiez la copier et l'exécuter telle quelle. Cliquez à nouveau pour la masquer. Les anciennes clés (créées avant le déploiement de la fonctionnalité d'affichage) conservent un espace réservé `PASTE_PLAINTEXT_FOR_<key-name>` ; régénérez la clé depuis la page **Clés API** pour la rendre affichable.

L'affichage est consigné dans un journal d'audit sur le serveur à chaque fois, et la clé en clair ne réside en mémoire que pour la session de page actuelle.

## Enregistrer des préréglages

Si vous reconfigurez régulièrement la même cible, enregistrez-la. Cliquez sur **Enregistrer** sur la ligne des onglets de request pour stocker la configuration actuelle sous forme de préréglage nommé.

Ouvrez **Enregistrés** dans la barre d'outils pour voir vos préréglages. Cliquez sur **Charger** pour remplir le formulaire, ou sur **Supprimer** pour en retirer un.

Une request ouverte depuis l'onglet DevTools de l'extension Chrome FourA se charge avec la clé de l'extension sélectionnée si cette clé se trouve dans votre compte, et la page l'indique. Sinon, elle vous demande de choisir une clé. Une request rejouée qui ne définit pas `unblocker` s'exécute avec cette option activée, comme le fait l'API.

| Champ du préréglage | Ce qu'il stocke |
|---------------------|-----------------|
| Nom | Un court libellé (jusqu'à 100 caractères) |
| Description | Notes facultatives (jusqu'à 500 caractères) |
| Endpoint | Le moteur auquel le préréglage est destiné (auto / single / proxy / browser) |
| Configuration | La charge utile complète de la request, incluant les champs d'interface, headers, cookies et le body |

Les préréglages sont associés à votre compte utilisateur et ne sont pas partagés avec les membres de l'équipe.

## Rejouer depuis l'historique

Chaque request que vous exécutez est journalisée. Ouvrez **Historique** dans la barre d'outils pour voir vos 20 dernières exécutions, classées de la plus récente à la plus ancienne.

Chaque ligne affiche l'endpoint, l'URL cible, le statut et l'heure. Cliquez sur **Replay** sur n'importe quelle ligne pour recharger cette request dans le formulaire, puis sur **Send** pour l'exécuter à nouveau.

L'historique est automatiquement limité à votre compte : vous ne voyez que vos propres exécutions.

## Ouverture depuis Activity

La boîte de dialogue détaillée du [Activity Log](https://foura.ai/docs/dashboard/activity-log) comporte un bouton **Open in Playground**. Cliquez dessus et le Playground se charge avec la request archivée et la response archivée. Le formulaire se remplit à partir du payload stocké, et la carte de response affiche ce que l'API a renvoyé à ce moment précis avec un badge « archived » sur le bandeau de métadonnées du proxy (« archived <time> [, truncated] [, via <proxy>] »).

À partir de là, vous pouvez modifier un paramètre et cliquer sur **Send** pour exécuter une nouvelle request sur l'API en direct, ou simplement inspecter le payload archivé sans le réexécuter. Les payloads sont conservés pendant 24 heures, les lignes plus anciennes d'Activity n'auront donc pas de response rechargeable.

## Conseils

- Commencez dans le Playground avant d'écrire du code pour une nouvelle cible. Avec Auto activé, vous saurez en quelques secondes si un simple fetch économique suffit ou si le site impose une résolution par navigateur.
- Pour les cibles géo-bloquées par pays, exécutez un appel Proxy avec `exitCountries` défini, puis transmettez l'ID de proxy renvoyé dans un appel Browser pour que le rendu JavaScript s'effectue via la même sortie.
- Enregistrez un preset pour chaque cible que vous scrapez régulièrement. Rejouer un preset enregistré ne prend qu'un clic ; reconstruire la request de mémoire prend plus de temps.
- Utilisez l'onglet Cookies pour déboguer le scraping basé sur les sessions. La vue brute Set-Cookie montre exactement ce que la cible a envoyé.
- Lorsqu'une cible vous refuse l'accès, essayez une autre entrée dans les sélecteurs de profil Browser avant d'utiliser un moteur plus lourd. Changer le navigateur présenté est gratuit ; un rendu par navigateur ne l'est pas.
- Les requests du Playground sont facturées sur la clé que vous sélectionnez. Utilisez une clé dédiée à faible quota pour vos explorations occasionnelles si vous souhaitez préserver la propreté de vos métriques de production.

## Liens connexes

- [API Endpoints](https://foura.ai/docs/api/endpoints) : Référence complète des paramètres pour les quatre moteurs, y compris `exitCountries` et les champs de profil de navigateur
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch) : Fonctionnement interne du mode Auto
- [Choosing the Right Endpoint](https://foura.ai/docs/guides/choosing-task-type) : Quand choisir Auto, Single, Proxy ou Browser
- [API Keys](https://foura.ai/docs/dashboard/api-keys) : Gérez les clés avec lesquelles vous authentifiez les requests du Playground
- [Activity Log](https://foura.ai/docs/dashboard/activity-log) : Ouvrez une request passée directement dans le Playground
- [Dashboard Overview](https://foura.ai/docs/dashboard/overview) : Toutes les sections de la barre latérale
