Points clés
Était-ce le site qui a répondu par un refus, ou votre forfait ? Chaque request refusée par votre forfait répond désormais via un seul header, et Auto ainsi que le Playground lisent également cette réponse. Le port du proxy sait désormais mémoriser le ciblage sur la clé, et le rendu Browser ainsi que la résolution de CAPTCHA sont inclus dans chaque forfait, y compris Free.
Nouveautés
Un refus qui identifie son origine
Lorsque l'une des limites de votre forfait rejette une request, la response inclut un header X-FourA-Limit précisant laquelle : plan_limit_credits, plan_limit_rate, plan_limit_browser_daily et quatre autres. Le body reprend ce code sous reason, à côté du seuil qui vous est appliqué. Les limites partagées de notre plateforme ne définissent jamais ce header, sa simple présence vous 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 provient desormais du forfait auquel vous avez souscrit, et Usage & Limits detaille chacune d'entre elles ainsi que votre niveau de consommation pour la periode. La reference des rate limits liste les sept codes ainsi que ceux qu'une breve attente permet de debloquer.
Auto lit ce meme code et agit en consequence. Une limite qui bloque un niveau (par exemple le quota journalier de sessions de navigation) laisse le reste de la chaine operationnel, et les adresses de sortie deja tentees ne sont pas considerees comme responsables d'un refus applique par votre forfait. Une limite indiquant que le compte a epuise ses ressources, comme les credits, la bande passante ou un produit non inclus dans votre forfait, arrete immediatement la chaine et vous renvoie le refus sans tester inutilement les autres routes. Rien de tout cela ne change la vocation de Auto: laissez-le determiner le bon niveau, puis rejouez la session retournee sur /api/single ou /api/browser pour y router votre trafic.
Le Playground explicite ce processus. Une ligne au-dessus de la response indique le mode de transmission utilise: une session existante pour cet hote, une request simple, un proxy tournant ou un veritable navigateur, ainsi que la resolution ou non d'un defi de securite, la tentative ayant abouti et son cout. Lorsque votre forfait a interrompu la request, la ligne debute par "Stopped by your plan, not by the site" et precise la limite atteinte.
Le proxy port, en version beta
Le proxy port permet a tout client acceptant une URL de proxy d'acheminer son trafic via nos sorties, sans aucun appel API. Il s'agit d'une version beta: le trafic transitant par ce port n'est pas encore facture, aucun engagement de continuite de service n'est associe et le nom des options peut encore evoluer.
Cette semaine, les options disponibles ont ete clarifiees: le reseau mutualise, qui correspond a nos propres sorties incluses dans votre forfait, ou le reseau residentiel, compose d'adresses d'utilisateurs deduites du trafic premium de votre forfait. Le basculement vers le reseau residentiel lorsque le reseau mutualise ne peut pas acheminer une request est une option distincte, desactivee par defaut. Cocher cette case a votre place reviendrait a decider de consommer votre forfait a vos depens.
Le ciblage est desormais rattache aux identifiants. Enregistrez un pays, une region, une ville ou un type d'appareil sur un utilisateur de proxy, et chaque connexion etablie avec ces identifiants respectera cette configuration. La chaine de connexion se reduit ainsi a l'identifiant brut, complete des seuls parametres specifiques. Le nom d'utilisateur reste neanmoins prioritaire pour une connexion donnee, et any permet d'outrepasser une valeur enregistree: -city-any cible l'ensemble du pays a partir d'une cle associee a une ville specifique.
Vous executez un profil de navigateur par adresse? Indiquez le nombre d'adresses persistantes souhaite et la page affiche une ligne par adresse, avec son propre nom de session. Le bouton New names genere une nouvelle serie d'identifiants lorsqu'une cible a bloque l'ancienne, et les lignes sont fournies au format URL ou host:port:user:pass, la structure la plus couramment importee par les gestionnaires de proxy. La documentation du proxy port detaille l'ensemble de la syntaxe des noms d'utilisateur.
Les pages protegees, disponibles sur tous les forfaits
Le rendu de navigateur et la résolution de CAPTCHA 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, ce qui vous permet de voir une page protégée s'afficher sur votre propre URL avant de payer quoi que ce soit.
Les sorties premium sur Proxy Finder ne dépendent plus du site ciblé. 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 les éléments imprimés sur votre facture et déterminent l'application de la TVA, lors du paiement et à chaque renouvellement. Si vous saisissez des informations différentes dans le formulaire de paiement, elles remplacent ces champs uniquement pour ce règlement.
Si nous vous avons configuré un forfait dans le cadre d'un contrat signé, Plan & Usage vous le propose désormais avec un bouton Confirm : choisissez la facturation mensuelle ou annuelle, ajoutez une carte, et vous payez l'intégralité de la période à l'avance, sans calcul au prorata.
Deux nouvelles cartes apparaissent à côté des crédits sur la page Plan & Usage, une pour la bande passante et une pour le trafic premium, affichant chacune votre consommation par rapport aux limites de votre forfait et aux recharges achetées. Lorsqu'une recharge correspondante est disponible, le bouton Buy figure directement sur la carte concernée. Le guide de facturation détaille ces deux éléments.
Sous le capot
Votre rate limit par minute comptabilise précisément le trafic envoyé durant cette minute, jusqu'au passage à la suivante. Les tableaux du dashboard s'adaptent aux écrans d'ordinateurs portables, et sur mobile, les tableaux larges défilent horizontalement dans leur propre cadre. Les tableaux du blog défilent de la même façon sur les écrans étroits. De plus, la page de votre organisation affiche immédiatement les invitations en attente dès son ouverture.
Un refus explicite permet d'anticiper. La prochaine fois qu'un traitement s'interrompt, un seul header vous indique s'il faut attendre une seconde, patienter jusqu'à minuit UTC, ou vérifier votre forfait.