> ## Documentation Index > Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Instructions de connexion pour les agents mondiaux > Global Rotation Agent 集成指南 - XHuoAPI Ce document présente principalement les instructions de connexion pour les agents mondiaux d'XHuoAPI, y compris les méthodes de demande, les méthodes pratiques, etc. ## Méthode de demande Pour utiliser le service mondial, vous pouvez d'abord vous rendre sur la «[page de demande](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)» pour faire une demande, la première demande bénéficie d'un quota gratuit de 1 point. ![](https://cdn.xhuoapi.ai/cyzvmz.png) Si vous n'êtes pas encore connecté, vous serez automatiquement redirigé vers la page de connexion, après vous être connecté, vous pourrez continuer votre demande. ## Méthode d'utilisation Une fois la demande terminée, vous pouvez consulter le résultat de votre demande dans le « tableau de bord », comme indiqué sur l'image : ![](https://cdn.xhuoapi.ai/y9boi5.png) Cliquez sur « Credentials » pour voir le nom d'utilisateur et le mot de passe pour utiliser le service d'agent mondial, séparés par un deux-points, où le nom d'utilisateur est de 8 caractères et le mot de passe est de 32 caractères, comme indiqué sur l'image : ![](https://cdn.xhuoapi.ai/ixwm85.png) Cet agent est un agent tournant (Rotating Proxy), donc lors de son utilisation, il suffit de définir une adresse et un port d'agent fixes, l'adresse et le port de l'agent sont respectivement `global.proxy.xhuoapi.ai` et `30007`, cet agent est un proxy pour les protocoles HTTP/HTTPS/SOCKS, et peut être utilisé pour demander des sites Web utilisant les protocoles HTTP et HTTPS. > Remarque : Cet agent ne peut être utilisé que dans un environnement réseau en dehors de la Chine, il ne peut pas être utilisé en Chine continentale. ## Test de commande Une fois que vous avez le nom d'utilisateur et le mot de passe de l'agent, la méthode la plus simple est de tester via la ligne de commande curl, si vous ne l'avez pas encore installé, veuillez vous référer à [https://curl.se/](https://curl.se/) pour l'installer. Si le nom d'utilisateur et le mot de passe de l'agent actuel sont `1f78266a:eff0896726224fa2a99fe82dd1f07562`, nous pouvons effectuer un test avec la commande curl suivante : ```shell theme={null} curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Ici, nous utilisons le paramètre `-x` de curl pour spécifier l'adresse de l'agent, le protocole de l'agent par défaut est HTTP/HTTPS, l'URL demandée est [https://ipinfo.io](https://ipinfo.io), ce site peut renvoyer l'adresse IP réelle de la demande et la région de l'IP. > Remarque : Le nom d'utilisateur et le mot de passe ci-dessus peuvent être invalides, veuillez les remplacer par votre nom d'utilisateur et mot de passe. Le résultat de l'exécution est le suivant : ```json theme={null} { "ip": "66.206.249.77", "hostname": "host-66-206-249-77.public.eastlink.ca", "city": "Kirkland Lake", "region": "Ontario", "country": "CA", "loc": "48.1446,-80.0377", "org": "AS11260 EastLink", "postal": "P2N", "timezone": "America/Toronto", "readme": "https://ipinfo.io/missingauth" } ``` On peut voir que le pays dans le résultat retourné est CA, représentant le Canada. Si vous exécutez à nouveau, vous obtiendrez un résultat différent, chaque demande ayant une sortie IP aléatoire. ## Intégration de code Prenons Python comme exemple pour démontrer la méthode de configuration de cet agent : ```python theme={null} import requests proxy = 'http://{proxy_username}:{proxy_password}@global.proxy.xhuoapi.ai:30007' proxies = { 'http': proxy, 'https': proxy } for _ in range(3): resp = requests.get('https://ipinfo.io', proxies=proxies) print(resp.text) ``` Ici, nous avons d'abord déclaré l'URL de l'agent et l'avons définie comme variable proxy, le protocole est le protocole http, suivi du nom d'utilisateur et du mot de passe de l'agent (c'est-à-dire le nom d'utilisateur et le mot de passe affichés dans le tableau de bord, séparés par un deux-points), suivi d'un symbole `@`, puis de l'adresse et du port de l'agent. > Remarque : Vous devez remplacer `{proxy_username}:{proxy_password}` dans le code ci-dessus par votre nom d'utilisateur et mot de passe d'agent, le résultat final sera similaire à `proxy = 'http://1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007'`, notez qu'il n'y a pas de caractères `{` et `}`. Ensuite, nous avons déclaré une variable proxies, configurant deux paires clé-valeur, avec les noms de clé http et https, dont les valeurs sont toutes proxy, représentant que pour les sites Web utilisant les protocoles HTTP et HTTPS, la demande sera effectuée en utilisant l'agent défini par la variable proxy. Ensuite, nous avons défini une boucle de trois fois pour tester l'agent. Le résultat de l'exécution est le suivant : ```python theme={null} { "ip": "103.190.205.165", "hostname": "assigned-for-client.adnsl.com", "city": "Paltan", "region": "Dhaka Division", "country": "BD", "loc": "23.7362,90.4143", "org": "AS38203 ADN Telecom Ltd.", "postal": "1000", "timezone": "Asia/Dhaka", "readme": "https://ipinfo.io/missingauth" } { "ip": "74.111.25.181", "hostname": "pool-74-111-25-181.syrcny.fios.verizon.net", "city": "Syracuse", "region": "New York", "country": "US", "loc": "43.0481,-76.1474", "org": "AS701 Verizon Business", "postal": "13201", "timezone": "America/New_York", "readme": "https://ipinfo.io/missingauth" } { "ip": "207.113.168.248", "city": "LaPorte", "region": "Indiana", "country": "US", "loc": "41.6106,-86.7225", "org": "AS13428 Surf Air Wireless, LLC", "postal": "46350", "timezone": "America/Chicago", "readme": "https://ipinfo.io/missingauth" } ``` On peut voir que chaque fois que le résultat de l'exécution obtient une IP d'agent aléatoire, et que la région de l'IP provient effectivement de différents pays et villes du monde. Bien sûr, la méthode de configuration de l'agent ci-dessus est en réalité une méthode de configuration relativement simple. En réalité, le code ci-dessus est équivalent à la définition d'un en-tête supplémentaire lors de la demande - Proxy Authorization, donc le code ci-dessus peut également être réécrit comme suit : ```python theme={null} import requests import base64 proxy_host = 'global.proxy.xhuoapi.ai' proxy_port = '30007' proxy_username = '{proxy_username}' # nom d'utilisateur de 8 caractères proxy_password = '{proxy_password}' # mot de passe de 32 caractères credentials = base64.b64encode( f'{proxy_username}:{proxy_password}'.encode()).decode() proxies = { 'http': f'http://{proxy_host}:{proxy_port}', 'https': f'http://{proxy_host}:{proxy_port}' } headers = { 'Proxy-Authorization': f'Basic {credentials}' } for _ in range(3): resp = requests.get('https://ipinfo.io', proxies=proxies, headers=headers) print(resp.text) ``` On peut voir qu'ici, nous avons défini le nom d'utilisateur et le mot de passe de l'agent via l'en-tête de requête Proxy-Authorization (qui doit être encodé en Base64), le fonctionnement de ce code est également le même. Pour d'autres langages, comme JavaScript avec axios, une méthode de configuration similaire peut également être utilisée : ```javascript theme={null} const axios = require("axios"); const base64 = require("base64"); const proxy_host = "global.proxy.xhuoapi.ai"; const proxy_port = "30007"; const proxy_username = "{proxy_username}"; // 8 caractères de nom d'utilisateur const proxy_password = "{proxy_password}"; // 32 caractères de mot de passe const credentials = base64.encode(`${proxy_username}:${proxy_password}`); const proxies = { http: `http://${proxy_host}:${proxy_port}`, https: `http://${proxy_host}:${proxy_port}`, }; const headers = { "Proxy-Authorization": `Basic ${credentials}`, }; for (let i = 0; i < 3; i++) { axios .get("https://ipinfo.io", { proxies, headers }) .then((resp) => console.log(resp.data)) .catch((err) => console.error(err)); } ``` Les résultats de l'exécution sont tous les mêmes. Pour les méthodes de configuration dans d'autres langues, veuillez vous référer au texte ci-dessus et les réécrire vous-même. ## Filtrage par région Nous pouvons filtrer par région en ajoutant une région dans le nom d'utilisateur, par exemple, si nous voulons choisir un proxy américain, le nom d'utilisateur d'origine est `1f78266a`, nous pouvons modifier le nom d'utilisateur en `1f78266a-region-us`, le curl ci-dessus peut être réécrit comme suit : ``` curl -x 1f78266a-region-us:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Liste des régions : | Nom du pays ou de la région | Code du pays/région | | ---------------------------------------- | ------------------- | | États-Unis | us | | Hong Kong | hk | | Andorre | ad | | Émirats Arabes Unis | ae | | Afghanistan | af | | Antigua-et-Barbuda | ag | | Anguilla | ai | | Albanie | al | | Arménie | am | | Angola | ao | | Antarctique | aq | | Argentine | ar | | Samoa Américain | as | | Autriche | at | | Australie | au | | Aruba | aw | | Îles Åland | ax | | Azerbaïdjan | az | | Bosnie-Herzégovine | ba | | Barbade | bb | | Bangladesh | bd | | Belgique | be | | Burkina Faso | bf | | Bulgarie | bg | | Bahreïn | bh | | Burundi | bi | | Bénin | bj | | Saint-Barthélemy | bl | | Bermudes | bm | | Brunei | bn | | Bolivie | bo | | Caraïbes néerlandaises | bq | | Brésil | br | | Bahamas | bs | | Bhoutan | bt | | Île Bouvet | bv | | Botswana | bw | | Biélorussie | by | | Belize | bz | | Canada | ca | | Îles Cocos | cc | | Afrique Centrale | cf | | Suisse | ch | | Chili | cl | | Cameroun | cm | | Colombie | co | | Costa Rica | cr | | Cuba | cu | | Cap-Vert | cv | | Île Christmas | cx | | Chypre | cy | | République tchèque | cz | | Allemagne | de | | Djibouti | dj | | Danemark | dk | | Dominique | dm | | République dominicaine | do | | Algérie | dz | | Équateur | ec | | Estonie | ee | | Égypte | eg | | Sahara Occidental | eh | | Érythrée | er | | Espagne | es | | Finlande | fi | | Fidji | fj | | États fédérés de Micronésie | fm | | Îles Féroé | fo | | France | fr | | Gabon | ga | | Grenade | gd | | Géorgie | ge | | Guyane française | gf | | Ghana | gh | | Gibraltar | gi | | Groenland | gl | | Guinée | gn | | Guadeloupe | gp | | Guinée équatoriale | gq | | Grèce | gr | | Guatemala | gt | | Guam | gu | | Guinée-Bissau | gw | | Guyana | gy | | Îles Heard et McDonald | hm | | Honduras | hn | | Croatie | hr | | Haïti | ht | | Hongrie | hu | | Indonésie | id | | Irlande | ie | | Israël | il | | Île de Man | im | | Inde | in | | Territoire britannique de l'océan Indien | io | | Irak | iq | | Iran | ir | | Islande | is | | Italie | it | | Île de Jersey | je | | Jamaïque | jm | | Jordanie | jo | | Japon | jp | | Cambodge | kh | | Kiribati | ki | | Comores | km | | Koweït | kw | | Îles Caïmans | ky | | Liban | lb | | Liechtenstein | li | | Sri Lanka | lk | | Libéria | lr | | Lesotho | ls | | Lituanie | lt | | Luxembourg | lu | | Lettonie | lv | | Libye | ly | | Maroc | ma | | Monaco | mc | | Moldavie | md | | Monténégro | me | | Saint-Martin | mf | | Madagascar | mg | | Îles Marshall | mh | | Macédoine | mk | | Mali | ml | | Myanmar | mm | | Macao | mo | | Martinique | mq | | Mauritanie | mr | | Île de Montserrat | ms | | Malte | mt | | Maldives | mv | | Malawi | mw | | Mexique | mx | | Malaisie | my | | Namibie | na | | Niger | ne | | Île Norfolk | nf | | Nigéria | ng | | Nicaragua | ni | | Pays-Bas | nl | | Norvège | no | | Népal | np | | Nauru | nr | | Oman | om | | Panama | pa | | Pérou | pe | | Polynésie française | pf | | Papouasie-Nouvelle-Guinée | pg | | Philippines | ph | | Pakistan | pk | | Pologne | pl | | Îles Pitcairn | pn | | Porto Rico | pr | | Palestine | ps | | Palaos | pw | | Paraguay | py | | Qatar | qa | | La Réunion | re | | Roumanie | ro | | Serbie | rs | | Russie | ru | | Rwanda | rw | | Îles Salomon | sb | | Seychelles | sc | | Soudan | sd | | Suède | se | | Singapour | sg | | Slovénie | si | | Slovaquie | sk | | Sierra Leone | sl | | Saint-Marin | sm | | Sénégal | sn | | Somalie | so | | Suriname | sr | | Soudan du Sud | ss | | Sao Tomé-et-Principe | st | | Salvador | sv | | Syrie | sy | | Eswatini | sz | | Îles Turques et Caïques | tc | | Tchad | td | | Togo | tg | | Thaïlande | th | | Tokelau | tk | | Timor-Leste | tl | | Tunisie | tn | | Tonga | to | | Turquie | tr | | Tuvalu | tv | | Tanzanie | tz | | Ukraine | ua | | Ouganda | ug | | Uruguay | uy | | Vatican | va | | Venezuela | ve | | Îles Vierges britanniques | vg | | Îles Vierges américaines | vi | | Vietnam | vn | | Wallis et Futuna | wf | | Samoa | ws | | Yémen | ye | | Mayotte | yt | | Afrique du Sud | za | | Zambie | zm | | Zimbabwe | zw | | Congo (B) | cg | | Congo (K) | cd | | Mozambique | mz | | Île de Guernesey | gg | | Gambie | gm | | Îles Mariannes du Nord | mp | | Éthiopie | et | | Nouvelle-Calédonie | nc | | Vanuatu | vu | | Terres australes françaises | tf | | Niue | nu | | Îles mineures éloignées des États-Unis | um | | Îles Cook | ck | | Royaume-Uni | gb | | Trinité-et-Tobago | tt | | Saint-Vincent-et-les-Grenadines | vc | | **###** | tw | | Nouvelle-Zélande | nz | | Arabie Saoudite | sa | | Laos | la | | Corée du Nord | kp | | Corée du Sud | kr | | Portugal | pt | | Kirghizistan | kg | | Kazakhstan | kz | | Tadjikistan | tj | | Turkménistan | tm | | Ouzbékistan | uz | | Saint-Kitts-et-Nevis | kn | | Saint-Pierre-et-Miquelon | pm | | Sainte-Hélène | sh | | Sainte-Lucie | lc | | Maurice | mu | | Côte d'Ivoire | ci | | Kenya | ke | | Mongolie | mn | ## IP fixe Comme pour le contenu ci-dessus, nous pouvons réaliser une IP fixe pendant un certain temps en ajoutant `session` dans le nom d'utilisateur et en ajoutant un numéro fixe de 5 chiffres, avec une durée de validité d'environ 10 minutes. Par exemple, si vous souhaitez réaliser une IP fixe pendant un certain temps, et que le nom d'utilisateur original est `1f78266a`, vous pouvez modifier le nom d'utilisateur en `1f78266a-session-12345`, où `12345`, s'il reste inchangé, alors l'IP ne changera pas pendant un certain temps. La commande curl ci-dessus peut être réécrite comme suit : ``` curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` ## Acheter plus Si votre forfait est épuisé, vous devez en acheter davantage pour continuer à utiliser ce service de proxy. Pour acheter plus, veuillez vous rendre sur la «[page de demande](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)» et cliquer directement sur le bouton «Acheter plus» pour sélectionner, plus vous achetez en une seule fois, moins le prix unitaire est cher.