Docs › Guides › Choisir le bon endpoint

Choisir le bon endpoint

FourA propose trois endpoints API, chacun optimisé pour des scénarios différents. Choisir le bon permet de gagner du temps, de réduire les coûts et d'améliorer les taux de réussite.

Guide de décision rapide

Utilisez l'endpoint single lorsque :

  • La page cible est générée côté serveur (aucun JavaScript requis)
  • Vous avez besoin d'une vitesse maximale (généralement moins d'une seconde)
  • Vous collectez des données à partir d'API ou de pages HTML statiques

Utilisez l'endpoint browser lorsque :

  • La page s'appuie sur JavaScript pour afficher le contenu
  • Le contenu se charge de manière dynamique après le chargement initial de la page
  • Vous avez besoin du DOM entièrement généré

Utilisez l'endpoint proxy lorsque :

  • Le site cible bloque activement les requests
  • Vous devez effectuer une rotation entre plusieurs adresses IP
  • Les tentatives précédentes ont renvoyé des pages 403 ou CAPTCHA

Comparaison des endpoints

Single (POST /api/single/)

L'option la plus rapide. Envoie une request HTTP avec des caractéristiques réseau réalistes semblables à celles d'un navigateur, sans lancer de processus de navigateur.

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/api/products", "unblocker": true}'

Temps de response typique : 200ms à 2s Idéal pour : API, sites d'actualités, blogs, pages de produits statiques

Browser (POST /api/browser/)

Ouvre votre URL dans une instance de navigateur Chrome. La page se charge complètement, le JavaScript s'exécute et vous obtenez l'HTML final généré.

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/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'

Temps de response typique : 2s à 10s Idéal pour : Applications monopages (SPA), sites avec lazy loading, contenu généré par JavaScript

Proxy (POST /api/proxy/)

Combine les requests HTTP avec une rotation automatique des proxies. Si la première tentative échoue ou est bloquée, FourA réessaie via différents proxies.

curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing",
      "unblocker": true
    }
  }'

Temps de response typique : 1s à 5s Idéal pour : Surveillance des prix e-commerce, agrégateurs de voyages, sites avec détection de bots

Quand combiner les approches

Certains workflows bénéficient de l'utilisation de plusieurs endpoints :

  1. Commencez par single : testez si la page renvoie des données utiles sans navigateur.
  2. Repliez-vous sur browser : si la response est vide ou s'il manque du contenu, passez au rendu par navigateur.
  3. Ajoutez proxy : si vous êtes bloqué (403/CAPTCHA), enveloppez votre request dans l'endpoint proxy pour une rotation automatique des adresses IP.

Cette approche progressive permet de maintenir des coûts bas tout en maximisant les taux de réussite.

Conseils de performance

  • Utilisez l'endpoint single par défaut et ne passez au niveau supérieur que si nécessaire
  • Définissez checkText dans les requests browser pour éviter d'attendre du contenu inutile
  • Définissez maxTries dans les requests proxy pour contrôler le comportement de tentative (la valeur par défaut est 5, le maximum est 90)
  • Gardez des valeurs de timeout_ms raisonnables : 10 à 15 secondes pour la plupart des pages

Étapes suivantes

Mis à jour : 30 juin 2026
Gérer la protection anti-bot →