Port du proxy

Envoyez votre propre trafic via les sorties de FourA depuis n'importe quel client acceptant une URL de proxy : un navigateur, un outil de téléchargement ou un scraper existant. Le port proxy ouvre un tunnel vers la cible indiquée et transmet les octets dans les deux sens. Il prend ainsi en charge ce que l'API JSON ne gère pas : les flux, les téléchargements volumineux et les sessions complètes de navigateur.

Bêta. Le port proxy est en version bêta. Le trafic qui y transite n'est pas encore facturé, n'est pas couvert par le monitoring ni par un engagement de disponibilité (SLA), et le nom des options peut encore changer. Signalez-nous tout dysfonctionnement.

Connexion

Les identifiants proviennent du tableau de bord. Créez un utilisateur proxy sous Proxy dans la barre latérale pour obtenir un identifiant et un mot de passe générés. Ils sont volontairement distincts de votre clé API : un handshake proxy transite en clair à chaque connexion, et un utilisateur proxy peut faire l'objet d'une rotation sans impacter votre intégration d'API. Consultez Proxy Users.

curl -x http://USERNAME:PASSWORD@proxy.foura.ai:34004 https://example.com

import requests

proxy = "http://USERNAME:PASSWORD@proxy.foura.ai:34004"
r = requests.get("https://example.com", proxies={"https": proxy, "http": proxy})
print(r.status_code)

Le port accepte uniquement CONNECT. Une cible https:// est tunnelisée par chaque client. Une cible http:// standard fonctionne si votre client la tunnelise également (curl : --proxytunnel) ; un client qui transmet directement la requête standard au proxy reçoit 405 Method Not Allowed.

Les options sont transmises dans le nom d'utilisateur

Tout ce qui suit l'identifiant est une liste de paires -key-value, dans n'importe quel ordre :

USERNAME-network-residential-country-de-session-a1

Les valeurs sont des mots en minuscules. Un tiret a l'interieur d'une valeur declenche une nouvelle option, donc -city-new-york est interprete comme deux options et se trouve refuse. Une cle inconnue est egalement refusee, jamais ignoree : une cle -contry-de mal orthographiee renvoie une erreur 400 listant les cles supportees, plutot que de router depuis le mauvais pays.

Toutes les options sauf network, fallback et session acceptent any, qui efface la valeur enregistree sur l'utilisateur proxy pour cette connexion specifique.

Trois combinaisons sont refusees avec une erreur 400 plutot que d'etre appliquees partiellement :

• state, city, asn, os ou lifetime sur le reseau shared. Le reseau shared se selectionne uniquement par pays sans niveau plus fin; ajoutez -network-residential pour cibler une ville.
• -fallback-residential associe a -network-residential. Un fallback n'a pas de sens sur le reseau vers lequel il bascule.
• Un ciblage plus precis avec un fallback arme. Un fallback pouvant se declencher ou non, une ville qui ne pourrait etre garantie systematiquement est refusee.

Sessions

Sur le reseau shared, une session nommee conserve le meme point de sortie tant que vous continuez a l'utiliser, selon une fenetre glissante de dix minutes. Si ce point de sortie cesse de fonctionner, la session bascule vers un autre plutot que d'echouer. Un navigateur pilote via le port doit toujours inclure un nom de session : le chargement d'une page ouvre des dizaines de connexions, et sans session chacune partira d'une adresse differente.

Sur le reseau residential, une session nommee conserve son adresse pendant lifetime minutes, ou selon la valeur par defaut du reseau si vous n'en definissez pas.

Parametres par defaut enregistres

Le ciblage enregistré sur un utilisateur de proxy dans le tableau de bord s'applique à chaque connexion établie avec celui-ci, ce qui permet de conserver un nom d'utilisateur court. Tout élément spécifié dans le nom d'utilisateur prévaut pour cette connexion unique, et any réinitialise une valeur enregistrée. Une valeur par défaut résidentielle enregistrée ne consomme du crédit que si votre forfait le permet ; sinon, la connexion est acheminée via le réseau partagé.

En-têtes CONNECT

Un client capable d'ajouter des en-têtes à la requête CONNECT peut envoyer les mêmes options sous forme d'en-têtes. Un en-tête prévaut sur la même option définie dans le nom d'utilisateur.

curl -x http://USERNAME:PASSWORD@proxy.foura.ai:34004 \
  --proxy-header "X-Foura-Country: de" \
  https://example.com

Réponses

Un tunnel qui s'ouvre renvoie 200 Connection established. Chaque refus comporte un header X-Foura-Error contenant la raison sur une ligne, lisez donc ce header en priorité.

Limites

• Jusqu'à 200 tunnels ouverts simultanément par proxy user.
• La recherche d'une sortie prend jusqu'à 45 secondes avant que le port n'abandonne avec une erreur 502. Une session disposant déjà d'une sortie se connecte généralement en bien moins d'une seconde.
• Un tunnel sans aucun octet transféré dans un sens ou dans l'autre est fermé après deux minutes d'inactivité.
• Un proxy user désactivé ou supprimé dans le tableau de bord cesse d'être authentifié dans un délai d'une minute.

Facturation et mesures

Les octets transitant par le port sont décomptés de la bande passante sur votre page Usage & Limits, et les octets passant par une sortie résidentielle sont également décomptés de votre trafic premium. Une connexion qui spécifie -network-residential une fois le quota premium épuisé est tout de même traitée; un repli ou une valeur résidentielle par défaut enregistrée n'est pas pris en compte dans cet état, et le réseau partagé traite la connexion à la place.

Voir aussi

• Proxy Users : Créez des proxy users et générez une chaîne de connexion dans le tableau de bord
• Proxy Request : L'alternative via l'API JSON, avec tentatives automatiques et validation intégrées
• Reuse a Proxy Across Requests : Conserver une même sortie sur l'API JSON
• Usage & Limits : Bande passante et trafic premium selon votre forfait