Playground

Le Playground (barre latérale > Playground) vous permet d'exécuter des requêtes API en direct avec votre vraie clé sans écrire de code. C'est le moyen le plus rapide d'essayer 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 à foura.ai/dashboard#playground.

Ce qu'il fait

Un formulaire. Quatre moteurs. Trafic réel.

• Auto : récupération intelligente. Vous passez une URL plus une règle validate et FourA choisit le chemin le moins cher qui fonctionne.
• Single : récupération HTTP directe avec des caractéristiques de fil réalistes semblables à celles d'un navigateur.
• Proxy : récupération de proxy géré avec rotation, éventuellement limité aux pays cibles visibles.
• Browser : ouvre l'URL dans une instance de navigateur Chrome pour les sites rendus en JS.

Les requêtes sont exécutées avec la clé API que vous choisissez en haut de la page. L'utilisation est déduite du quota de cette clé de la même manière qu'un appel de production, alors ne gaspillez pas votre forfait en tests.

Choisir une clé

Le menu déroulant de clé API affiche chaque clé active dans votre périmètre : clés personnelles, clés d'organisation que vous administrez et clés partagées en équipe auxquelles vous pouvez accéder. Choisissez celle sur laquelle vous souhaitez facturer la requête. Si vous n'avez pas encore de clés actives, une invite intégrée vous renvoie vers la page Clés API pour en créer une.

Choisir un mode

Une ligne Mode supérieure bascule entre Auto et les moteurs manuels. Lorsque Auto est sélectionné, le formulaire passe à la surface Auto minimale (URL plus validate plus quelques boutons). Lorsque vous désactivez Auto, trois boutons apparaissent : Single, Proxy, Browser. En changeant de bouton, vous changez les champs visibles et le moteur que la requête atteint. La sélection actuelle est conservée lorsque vous rechargez la page.

Mode	Quand l'utiliser
Auto	Nouvelle cible ou site à protection mixte. Auto choisit le chemin le moins cher et se souvient de 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 du proxy. Définissez exitCountries lorsque vous avez besoin d'un pays cible visible.
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 du haut contient la méthode HTTP (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS), l'URL cible et le bouton Envoyer. Single, Proxy et Auto honorent toutes les méthodes. Browser ignore la méthode (Chrome émet toujours GET pour la navigation) et le corps.

Onglets de requête

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

Onglet	Ce qu'il contrôle
UI	Champs de formulaire pour les délais d'attente, les redirections, les drapeaux, le proxy, les options spécifiques au navigateur et les règles de validation
Body	Corps libre pour les requêtes POST / PUT / PATCH
Headers	En-têtes de requête personnalisés sous forme de paires clé-valeur
Cookies	Cookies à envoyer avec la requête
Raw	La charge utile JSON exacte qui sera envoyée, modifiable directement

Tout ce que vous modifiez dans UI / Body / Headers / Cookies est reflété dans Raw. Modifier Raw fonctionne également, les autres onglets se mettant à jour en conséquence. Un point rouge apparaît sur tout onglet ou section repliable contenant une valeur différente des valeurs par défaut du moteur, afin que vous puissiez repérer d'un coup d'œil ce que vous avez personnalisé.

Sections du panneau UI

L'onglet UI regroupe les paramètres dans des sections repliables. Les champs vides se rabattent sur la valeur par défaut du schéma du moteur. Les sections qui ne s'appliquent pas au Mode actuel sont masquées.

• Timeouts: timeout_ms, connect_timeout_ms, accept_timeout_ms, server_response_timeout_ms, dns_cache_timeout_sec. Auto expose uniquement timeout_ms (le budget total).
• Redirects: activez et définissez followRedirects (0-20). Single, Proxy, Auto. Browser suit les redirections par lui-même.
• Flags: unblocker pour Single, Proxy et Browser (unblocker sur Browser déclenche le solveur de défense automatique); tryJsonData et returnBuffer pour Single et Proxy. Auto expose forceProxy et returnSession à la place.
• Proxy: choisissez un ID proxy spécifique pour Single ou Browser, ou définissez maxTries, le timeout externe Proxy, exitCountries et ignoreProxies pour le moteur Proxy. Auto expose également ignoreProxies.
• Browser profile: 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 le Chrome le plus récent. Chaque sélection restreint les deux autres, de sorte qu'une combinaison qui ne mène à rien n'apparaît jamais. La section nécessite que Web Unblocker soit activé : s'il est désactivé, aucun header de navigateur n'est envoyé, un profil ne s'appliquerait qu'à moitié, et l'API refuse la request à la place.
• Browser: options exclusives au navigateur telles que checkStatus et checkText.
• Validate: règles d'acceptation / d'échec pour validate.status (codes de statut), validate.headers (règles clé-valeur de header), et validate.data (sous-chaînes body accept / fail, alternatives séparées par |). Disponible pour chaque Mode, y compris Auto.

Délimitation du pays de sortie (Mode Proxy)

Le champ exitCountries sur Proxy accepte une liste de codes pays à deux lettres séparés par des virgules, visibles par la cible (CZ, GB). Les valeurs sont rognées, mises en majuscules et dédupliquées lors de la soumission. La sélection est une liste blanche stricte : les proxies avec des sorties inconnues sont exclus et la request ne se rabat jamais sur un autre pays. Si le pool actuel n'a pas de correspondance, la response renvoie code: "no_eligible_proxy" avec le périmètre demandé renvoyé dans details.exitCountries. Conservez le périmètre et réessayez plus tard.

Lorsqu'un appel proxy réussit sous cette délimitation, la bande de la response affiche exit <CODE> à côté de l'ID du proxy afin que vous puissiez vérifier que le pays servi correspond à ce que vous avez demandé.

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 à zéro. Comme c'est destructeur, il ouvre une boîte de dialogue de confirmation qui liste exactement ce qui sera effacé : les trois formulaires de produit (Single, Proxy, Browser), tous les cookies sauvegardés dans le jar, tous les proxies transférés et la réponse actuelle. Les préréglages sauvegardé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 spinner et un bouton Cancel pendant que l'appel est en cours. Cliquez sur Cancel (ou appuyez de nouveau sur le bouton sur mobile) pour abandonner. Une requête annulée restaure l'espace réservé inactif avec "Request canceled." au lieu d'afficher une erreur.

La carte de réponse passe au résultat au moment où la requête se termine (ou échoue). Les exécutions Auto peuvent prendre plus de temps que les moteurs manuels car l'échelle peut gravir plusieurs échelons 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	Ce qu'il montre
Body	Corps analysé. Bascule entre les vues JSON, HTML et Text selon ce qui a été renvoyé.
Headers	Headers de réponse, un par ligne.
Cookies	Cookies renvoyés par la cible, dans les vues analysées (groupées par hôte) et brutes (texte Set-Cookie). La vue analysée affiche un badge HO sur les cookies limités à l'hôte ; les cookies de domaine ne sont pas marqués.
Raw	L'enveloppe JSON complète renvoyée par l'API.

Une bande meta au-dessus des onglets montre le statut HTTP amont, le temps total, l'ID du proxy qui a géré l'appel et (pour un appel Proxy ciblé) le exit <CODE> à deux lettres. Pour les exécutions Auto, la bande montre également quel échelon de l'échelle a fourni la réponse, combien de sous-tentatives ont été effectuées et les crédits dépensés.

Transfert de valeurs entre les exécutions

Après toute exécution ayant renvoyé des données de session réutilisables, un petit contrôle Carry sur la barre d'outils de réponse montre ce qui est disponible :

• Les exécutions Auto offrent le triple session complet (proxy, cookies, userAgent).
• Les exécutions Browser offrent le userAgent de réponse, plus l'ID du proxy si un a été utilisé.
• Les exécutions Proxy offrent l'ID de proxy renvoyé.

Cliquez sur Carry et choisissez où appliquer chaque valeur en un clic : userAgent devient un header User-Agent sur Single ou Proxy, et l'ID du proxy va dans le champ proxy sur Single ou Browser. Les champs qui reçoivent une valeur transférée affichent le point rouge "modifié" pour que vous puissiez voir ce qui a changé.

Agrandir en plein écran

L'icône d'agrandissement sur la barre d'outils de réponse sort la carte de réponse de la disposition divisée pour l'afficher en plein écran. Utilisez-la pour les arbres JSON profonds, les longs vidages Set-Cookie ou les corps HTML larges où la colonne demi-largeur devient étroite. La page elle-même arrête de défiler pendant que l'incrustation est ouverte. Cliquez de nouveau sur l'icône (ou appuyez sur Échap) pour réduire.

Le reproducteur curl

Sous la réponse, un bloc cURL montre l'équivalent exact en ligne de commande de la requête que vous venez de construire. Copiez-le pour reproduire la requête depuis un terminal, la partager avec un collègue, ou la coller dans un rapport de bug.

Pour les clés révélables, un bouton Reveal key à côté de l'extrait insère la vraie clé en texte clair directement dans la commande cURL pour que vous puissiez copier et exécuter tel quel. Cliquez à nouveau pour masquer. Les anciennes clés (créées avant le lancement de la fonctionnalité de révélation) conservent un espace réservé PASTE_PLAINTEXT_FOR_<key-name>; régénérez la clé depuis la page API Keys pour la rendre révélable.

La révélation est journalisée sur le serveur à chaque fois, et la clé en clair ne réside en mémoire que pour la session de page en cours.

Sauvegarder des Presets

Si vous reconfigurez la même cible de façon répétée, sauvegardez-la. Cliquez sur Save dans la ligne des onglets de requête pour stocker la configuration actuelle sous forme de preset nommé.

Ouvrez Saved dans la barre d'outils pour parcourir, renommer ou supprimer vos presets. Cliquez sur n'importe quel preset pour le recharger dans le formulaire.

Champ du preset	Ce qu'il stocke
Name	Un libellé court (jusqu'à 100 caractères)
Description	Des notes facultatives (jusqu'à 500 caractères)
Endpoint	Le moteur auquel le preset est destiné (auto / single / proxy / browser)
Config	Le payload complet de la requête, incluant les champs de l'interface, les headers, les cookies et le body

Les presets sont limités à votre compte utilisateur et ne sont pas partagés avec les membres de l'équipe.

Rejouer depuis l'historique

Chaque requête que vous exécutez est journalisée. Ouvrez History dans la barre d'outils pour voir vos 20 dernières exécutions, de la plus récente à la plus ancienne.

Chaque ligne montre l'endpoint, l'URL cible, le statut et l'heure. Cliquez sur Replay sur n'importe quelle ligne pour recharger cette requête 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.

Ouvrir depuis l'activité

La boîte de dialogue de détails Activity Log possède un bouton Open in Playground. Cliquez dessus et le Playground se charge avec la requête archivée et la réponse archivée. Le formulaire se remplit à partir du payload stocké, et la carte de réponse montre ce que l'API a retourné à ce moment précis avec un badge "archived" sur la bande meta du proxy ("archived [, truncated] [, via ]").

À partir de là, vous pouvez modifier un paramètre et cliquer sur Send pour exécuter une nouvelle requête vers 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 d'activité plus anciennes n'auront donc pas de réponse rechargeable.

Astuces

• Commencez dans Playground avant d'écrire du code pour une nouvelle cible. Avec Auto activé, vous saurez en quelques secondes si un fetch économique suffit ou si le site impose une résolution par navigateur.
• Pour les cibles limitées géographiquement, exécutez un appel Proxy avec exitCountries configuré, puis transmettez l'ID du proxy retourné à un appel Browser afin que le rendu JavaScript s'effectue via la même sortie.
• Enregistrez un préréglage pour chaque cible que vous scrapez régulièrement. Rejouer un préréglage enregistré prend un clic, reconstruire la requête 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, essayez une autre entrée dans les sélections de profil de navigateur avant de recourir à un moteur plus lourd. Changer le navigateur présenté est gratuit, un rendu par navigateur ne l'est pas.
• Les requêtes Playground sont facturées sur la clé que vous choisissez. Utilisez une clé dédiée avec un faible quota pour l'exploration occasionnelle si vous souhaitez garder votre utilisation en production propre.

Liens associés

• API Endpoints: Référence complète des paramètres pour les quatre moteurs, incluant exitCountries et les champs de profil de navigateur
• Smart Fetch (Auto): Ce que Auto fait sous le capot
• Choosing the Right Endpoint: Quand choisir Auto, Single, Proxy ou Browser
• API Keys: Gérez les clés avec lesquelles vous authentifiez les requêtes Playground
• Activity Log: Ouvrez une requête passée directement dans Playground
• Dashboard Overview: Toutes les sections de la barre latérale