Comment votre forfait est mesuré
FourA propose deux produits, et ils sont mesurés selon des unités différentes. Votre forfait repose sur l'une de ces deux unités, ce qui détermine le quota qui s'applique à vos requêtes et les cartes affichées dans votre tableau de bord. Cette page résume l'ensemble du modèle sur un seul écran.
Deux produits, deux unités
| Produit | Vous appelez | L'unité |
|---|---|---|
| API | POST /api/single, /api/proxy, /api/browser, /api/auto |
Une request, facturée en crédits |
| Port proxy | proxy.foura.ai:34004 depuis tout client acceptant une URL de proxy |
Un tunnel, facturé en gigaoctets |
Sur l'API, seul un résultat success consomme des crédits. Une request qui échoue du côté de la cible, de votre côté ou du nôtre ne vous coûte rien. Le trafic premium est comptabilisé séparément des crédits, comme décrit ci-dessous. Consultez Request Outcomes.
Sur le port proxy, il n'y a ni crédits ni décompte de request, et ce n'est pas un oubli. Un tunnel correspond à une connexion unique ouverte par votre outil, et ce qu'il transmet est votre propre trafic chiffré, FourA ne peut donc mesurer que le tunnel et les octets transportés, sans détail plus fin. Un décompte de request ici donnerait un chiffre impossible à réconcilier avec vos propres journaux. Le port est donc toujours vendu au gigaoctet. Consultez Proxy Port.
Ce qu'est un gigaoctet et ce qu'il comprend
Un gigaoctet équivaut à 1 073 741 824 octets (2^30, unité également notée Gio). Chaque quota, compteur et tarif de votre forfait utilise cette valeur, tant sur l'API que sur le port proxy.
Les éléments comptabilisés varient selon le produit, car les deux ne transportent pas la même chose :
| Emplacement | Éléments comptabilisés |
|---|---|
| API, sorties standard | Le corps de la request que vous nous envoyez, plus le corps de la response que nous retournons. Les headers HTTP ne sont pas pris en compte, d'un côté comme de l'autre. |
| API, sorties premium | Chaque octet du transfert transitant sur le réseau, dans les deux sens, compressé et chiffré lors de l'acheminement. |
| Port proxy | Chaque octet transitant par le tunnel dans les deux sens une fois ouvert, y compris la configuration de la connexion chiffrée effectuée par votre client avec le site. L'ouverture du tunnel n'est pas comptabilisée, sauf si une sortie premium tentée par le port sans être utilisée lors de l'ouverture compte comme du trafic premium. |
Quelques conséquences utiles à connaître :
- La page est comptabilisée décodée, car la page décodée est ce que nous produisons. Y accéder peut impliquer l'exécution d'un véritable navigateur, la réalisation d'une étape supplémentaire demandée par la page, puis le décodage de la réponse pour vous fournir un contenu directement utilisable. Vous payez pour ce résultat final, non pour son niveau de compression lors du transfert. Le port proxy constitue l'autre cas de figure et suit une tarification différente: nous y acheminons votre propre connexion sans modifier son contenu, et nous comptabilisons donc les octets exactement tels qu'ils traversent le tunnel.
- Les nouvelles tentatives sur le pool standard ne vous coûtent rien. Lorsque Proxy Finder effectue une rotation à travers plusieurs sorties, vous ne payez qu'une seule fois pour la réponse reçue, quel que soit le nombre de sorties tentées. Sur une sortie premium, chaque tentative compte, car c'est ainsi que les réseaux premium nous facturent.
- Une session de navigateur sur une sortie standard est comptabilisée comme n'importe quelle autre réponse API: le body que nous vous renvoyons, et non chaque sous-ressource chargée par la page. Via une sortie premium, l'ensemble de la session passe sur le réseau et y est comptabilisé.
- Le trafic premium fait partie de votre total et ne s'y ajoute pas en surplus. Votre quota standard n'est débité que pour la partie qui n'a pas transité par une sortie premium.
- Un appel Auto ne génère aucun trafic propre. Les requêtes Single, Proxy Finder et Browser qu'il déclenche sont comptabilisées exactement comme si vous les aviez émises vous-même.
- Un refus émis par le site cible est comptabilisé; un refus lié à votre propre forfait ne l'est pas. Lorsqu'un site répond par un code 403, 404, 429 ou 5xx, nous vous transmettons cette réponse, elle est donc comptabilisée. Lorsqu'une limite de votre propre forfait bloque la requête, rien n'est récupéré et rien n'est facturé.
- Aucun arrondi n'est appliqué. Les octets sont comptabilisés à l'unité près, sans taille de bloc ni minimum par requête, et vos statistiques sont synchronisées chaque nuit avec notre base de métriques.
Deux modes de facturation des forfaits
Les deux compteurs fonctionnent pour chaque compte. Ce qui change est l'unité sur laquelle votre forfait est vendu.
Facturation aux crédits
L'API décompte des crédits par requête facturée. Le port proxy dispose de ses propres gigaoctets inclus, indiqués séparément, car un tunnel ne comporte pas de requête unitaire à laquelle imputer un crédit. Les deux volumes restent indépendants: votre trafic API ne consomme pas les gigaoctets du port proxy, et les tunnels du port ne consomment pas vos crédits. L'alternative reviendrait à facturer deux fois une même requête API, une première fois en crédits et une seconde fois via les octets générés par ces crédits.
Le plafond de trafic propre à l'API est désactivé, à moins que votre forfait n'en prévoie un explicitement.
Facturation au trafic
Un quota unique de trafic standard couvre à la fois l'API et le port proxy, les deux accès étant tarifiés selon la même unité. Un forfait structuré ainsi ne facture aucun crédit. Les crédits disparaissent donc entièrement du tableau de bord pour éviter d'afficher une valeur sans objet.
Trafic premium, commun aux deux modes
Le trafic premium dispose toujours de son propre quota distinct, quel que soit le type de forfait. Il n'est jamais inclus dans le volume standard, ce qui garantit qu'un gigaoctet n'est jamais imputé à deux plafonds différents. Vous ciblez une sortie premium avec exitClass: premium sur POST /api/proxy/ ou -network-premium sur le port proxy.
Le volume est mesure lorsqu'il traverse le reseau : dans les deux sens, compresse et chiffre tel qu'emis. Sur l'API, chaque tentative premium compte, y compris celle qui n'a pas renvoye votre page ; sur le port proxy, il s'agit du trafic de chaque tunnel premium, plus toute sortie premium que le port a tentee puis abandonnee lors de son ouverture.
Ce qui bloque vos requetes, et ou
| Quota | Sur l'API | Sur le port proxy |
|---|---|---|
| Credits pour la periode | 429 avec X-FourA-Limit: plan_limit_credits |
Non applicable |
| Trafic standard pour la periode | 429 avec X-FourA-Limit: plan_limit_bandwidth |
429 avec X-Foura-Error precisant le trafic |
| Tunnels ouverts simultanement | Non applicable | 429 avec X-Foura-Error |
| Ouvertures de tunnel par minute | Non applicable | 429 avec X-Foura-Error |
| Trafic premium | Retrograde, non refuse | 403 sur une requete explicite |
Une reponse CONNECT n'a pas de corps pour y inserer une erreur JSON, c'est pourquoi un refus de port correspond a un statut accompagne d'un header plutot qu'au format decrit dans Rate Limits. Lisez X-Foura-Error avant toute autre chose sur une connexion proxy.
L'epuisement du premium est la seule asymetrie
Les deux points d'entree repondent deliberement de maniere differente, car "j'ai demande a consommer" et "un parametre a ete defini pour moi autrefois" sont deux situations distinctes.
Sur l'API, un quota premium epuise n'interrompt jamais une tache. La requete est servie depuis le pool standard et la reponse indique exitClass: standard, afin que vous puissiez voir ce que vous avez reellement obtenu. Un forfait qui n'inclut aucune sortie premium renvoie une reponse differente : il s'agit d'un 403 avec plan_limit_premium.
Sur le port proxy :
- Une connexion qui precise
-network-premiumest refusee avec un403. Vous avez demande a consommer du premium, etre servi silencieusement depuis un autre emplacement vous obligerait a rapprocher une ligne premium qui n'apparait jamais. - Un reglage par defaut premium enregistre sur l'utilisateur proxy est retrograde vers le reseau partage, et le tunnel s'ouvre tout de meme. Vous ne l'avez pas explicitement selectionne pour cette connexion.
- Un declenchement arme via
-fallback-premiumne s'active simplement pas.
Acheter des supplements
Les recharges fonctionnent exactement de la meme maniere que ce qui est inclus dans le forfait. A chaque periode, le quota propre a votre forfait est utilise en premier, et seul le depassement est debite du solde que vous avez achete. Un achat reste valide pendant douze mois.
Le tableau de bord distingue les deux nombres partout ou il indique un quota (75,000 (50,000 incl + 25,000 bought)), afin que le chiffre a l'ecran puisse etre rapproche de la facture en votre possession.
Ou consulter vos propres donnees
| Page | Reponse apportee |
|---|---|
| Billing | Cette periode par rapport a ce qui est disponible, une carte par element mesure par votre forfait, avec un bouton Acheter sur chacune |
| Usage & Limits | Chaque limite a cote de son compteur en direct, plus une ventilation par cle, par endpoint et par utilisateur proxy |
| Overview | Volume et trafic sur n'importe quelle periode, par produit |
Les cartes affichées dans Facturation dépendent des deux cas ci-dessus : un forfait vendu aux crédits obtient une carte Crédits et une carte Trafic du port proxy ; un forfait vendu au trafic n'obtient ni l'une ni l'autre, et sa carte Trafic standard affiche le plafond ainsi que la mention L'API et le port proxy combinés.
Ne codez aucun de ces chiffres en dur. Chaque refus d'API indique le plafond qui l'a déclenché, et chaque refus de port le mentionne dans X-Foura-Error.
Sujets connexes
- Limites de débit : Chaque corps et en-tête de limite de forfait sur l'API
- Port Proxy : Mesure, codes de réponse et options de nom d'utilisateur
- Résultats des requêtes : Quels résultats sont facturés, pour les requêtes et pour les tunnels
- Facturation et abonnements : Forfaits, recharges et factures
- Utilisation et limites : Vos compteurs en temps réel par rapport à votre forfait