Points clés
Était-ce le site qui a refusé, ou votre forfait ? Chaque requête rejetée par votre forfait répond désormais via un seul header, et Auto ainsi que le Playground interprètent aussi cette réponse. Le port proxy mémorise désormais le ciblage sur la clé, et le rendu Browser, pages interactives incluses, est disponible avec chaque forfait, Free compris.
Nouveautés
Un refus qui identifie son auteur
Lorsqu'une des limites de votre forfait rejette une requête, la réponse inclut un header X-FourA-Limit indiquant laquelle : plan_limit_credits, plan_limit_rate, plan_limit_browser_daily et quatre autres. Le corps répète le code sous reason, à côté de la limite qui vous est appliquée. Les limites de notre plateforme partagée ne définissent jamais ce header, sa simple présence indique donc que le refus concerne votre compte, et non une surcharge de FourA.
import requests
r = requests.post(
"https://api.foura.ai/api/single",
headers={"X-API-Key": "pk_live_..."},
json={"url": "https://example.com/data"},
)
limit = r.headers.get("X-FourA-Limit")
if limit:
print("my plan stopped this:", limit, r.json()["error"])
Chaque limite de votre compte dépend désormais de votre forfait, et la section Usage & Limits affiche chacune d'elles ainsi que votre consommation pour la période en cours. La documentation des rate limits détaille les sept codes et indique ceux qu'une courte attente permet de réinitialiser.
Auto lit ce même code et s'y adapte. Une limite qui bloque un palier (par exemple, le quota quotidien de navigateurs) laisse le reste du flux actif, et les sorties déjà tentées ne sont pas jugées responsables d'un refus lié à votre forfait. Une limite indiquant que le compte est épuisé, comme les crédits, la bande passante ou un produit non inclus dans votre offre, interrompt immédiatement l'escalade et vous renvoie le refus sans tester inutilement les autres routes. Rien de tout cela ne change l'objectif d'Auto : laissez-le trouver le palier adéquat, puis rejouez la session obtenue sur /api/single ou /api/browser pour y router votre volume.
Le Playground détaille chaque étape. Une ligne au-dessus de la réponse précise ce qui a traité la page : une session existante pour cet hôte, une simple request, un proxy tournant ou un vrai navigateur, tout en indiquant si un challenge a été résolu, quelle tentative a réussi et ce que cela a coûté. Lorsque votre forfait bloque la requête, la ligne débute par « Arrêté par votre forfait, pas par le site » et nomme la limite atteinte.
Le port de proxy, en version bêta
Le port de proxy permet à tout client acceptant une URL de proxy d'acheminer son trafic via nos points de sortie, sans appel API. Il s'agit d'une version bêta : le trafic n'est pas encore facturé, aucun engagement de disponibilité n'est garanti, et les noms des options peuvent évoluer.
Cette semaine, les options disponibles ont été clarifiées : le réseau partagé, constitué de nos propres sorties et inclus dans votre forfait, ou le réseau résidentiel, composé d'adresses IP résidentielles issues de votre volume premium. Le basculement vers le réseau résidentiel si le réseau partagé échoue est une option distincte, désactivée par défaut. L'activer d'office reviendrait à consommer votre forfait à votre place.
Le ciblage est désormais rattaché à l'identifiant. Associez un pays, une région, une ville ou un type d'appareil à un utilisateur proxy et chaque connexion utilisera ces paramètres. La chaîne de connexion se résume ainsi au simple identifiant et aux paramètres spécifiques. Cependant, le nom d'utilisateur reste prioritaire pour une connexion donnée, et any réinitialise une valeur enregistrée : -city-any cible l'ensemble du pays depuis une clé configurée pour une seule ville.
Vous utilisez un profil de navigateur par adresse ? Définissez le nombre d'adresses persistantes souhaité et la page affichera une ligne par adresse, avec son propre nom de session. L'option New names génère un nouveau jeu d'identifiants lorsqu'une cible bloque les anciens, et les lignes sont fournies au format URL ou host:port:user:pass, la structure supportée par la plupart des gestionnaires de proxy. La documentation du port de proxy présente l'ensemble de la syntaxe des noms d'utilisateur.
Les pages protégées, sur tous les forfaits
Le rendu de navigateur et les pages interactives sont inclus dans chaque forfait, y compris l'offre Free, seules les limites changent. Les forfaits Free et Developer incluent également du trafic de sortie premium, afin que vous puissiez voir une page protégée se charger sur votre propre URL avant de payer quoi que ce soit.
Les sorties premium sur Proxy Finder ne dépendent plus du site cible visé. Envoyez exitClass: premium pour n'importe quelle cible et le trafic premium de votre forfait (ainsi que son solde restant) est le seul facteur déterminant.
Une facturation adaptée à vos informations
L'entreprise, le numéro de TVA et le pays enregistrés sous Billing Details sont reportés sur votre facture et déterminent l'application de la TVA, lors du paiement initial et à chaque renouvellement. Saisir des informations différentes dans le formulaire de paiement remplace ce champ uniquement pour ce règlement précis.
Si nous vous avons configuré un forfait dans le cadre d'un contrat signé, la page Plan & Usage vous le propose désormais avec un bouton Confirm : choisissez une facturation mensuelle ou annuelle, ajoutez une carte, et vous payez la période complète d'avance, sans calcul au prorata.
Deux nouvelles cartes s'affichent aux côtés des crédits sur Plan & Usage, l'une pour la bande passante et l'autre pour le trafic premium, chacune indiquant votre consommation par rapport à ce qui est inclus dans votre forfait et à vos éventuels achats supplémentaires. Lorsqu'une recharge correspondante est disponible, le bouton Buy apparaît directement sur la carte concernée. Le billing guide détaille ces deux éléments.
Sous le capot
Votre rate limit par minute comptabilise exactement le trafic émis pendant cette minute, jusqu'au passage à la suivante. Les tableaux du tableau de bord s'ajustent aux écrans d'ordinateurs portables, et sur mobile, les plus larges défilent horizontalement dans leur propre cadre. Les tableaux du blog adoptent le même comportement sur les écrans étroits. Enfin, la page de votre organisation liste les invitations en attente dès son ouverture.
Un refus explicite permet d'adapter vos processus. La prochaine fois qu'un traitement s'arrête, un unique header vous indique s'il faut patienter une seconde, attendre minuit UTC, ou vérifier votre forfait.