> ## 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. # Global Agent Integration Instructions > Global Rotation Agent 集成指南 - XHuoAPI Detta dokument beskriver huvudsakligen integrationen av XHuoAPI:s globala agenter, inklusive ansökningsmetoder, användningsmetoder och andra specifika innehåll. ## Ansökningsmetod För att använda globala tjänster kan du först gå till "[ansökningssidan](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)" för att göra en ansökan, den första ansökan har 1 poäng gratis kvot. ![](https://cdn.xhuoapi.ai/cyzvmz.png) Om du inte har loggat in kommer du automatiskt att omdirigeras till inloggningssidan, logga in och fortsätt med ansökan. ## Användningsmetod När ansökan är klar kan du gå till "kontrollpanelen" för att se din ansökningsresultat, som visas i bilden: ![](https://cdn.xhuoapi.ai/y9boi5.png) Klicka på "Credentials" för att se användarnamn och lösenord för att använda den globala agenttjänsten, separerade med kolon, där användarnamnet är 8 tecken och lösenordet är 32 tecken, som visas i bilden: ![](https://cdn.xhuoapi.ai/ixwm85.png) Denna agent är en roterande proxy (Rotating Proxy), så när du använder den behöver du bara ställa in en fast proxyadress och port, proxyadressen och porten är `global.proxy.xhuoapi.ai` och `30007`, denna proxy är en HTTP/HTTPS/SOCKS-proxy och kan användas för att begära webbplatser med HTTP- och HTTPS-protokoll. > Observera: Denna proxy kan endast användas i nätverksmiljöer utanför Kina, den kan inte användas i fastlands-Kina. ## Kommandotest När du har proxyanvändarnamn och lösenord är det enklaste sättet att testa via curl-kommandoraden, om du inte har installerat det, vänligen se [https://curl.se/](https://curl.se/) för installation. Om det aktuella proxyanvändarnamnet och lösenordet är `1f78266a:eff0896726224fa2a99fe82dd1f07562`, kan vi använda följande curl-kommando för att testa: ```shell theme={null} curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Här använder vi curl:s `-x`-parameter för att specificera proxyadressen, proxyprotokollet är som standard HTTP/HTTPS, och den begärda URL:en är [https://ipinfo.io](https://ipinfo.io), denna webbplats kan returnera den verkliga IP-adressen och platsen för IP:n som begärde webbplatsen. > Observera: Det ovanstående användarnamnet och lösenordet kan vara ogiltigt, vänligen ersätt med ditt användarnamn och lösenord. Resultatet ser ut som följer: ```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" } ``` Som du kan se är det returnerade resultatets land CA, vilket representerar Kanada. Om du kör det igen kan du få ett annat resultat, varje begäran har en slumpmässig IP-utgång. ## Kodintegration Nedan visas hur man ställer in denna proxy med Python: ```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) ``` Här deklarerar vi först proxy-URL:en och definierar den som proxy-variabeln, protokollet är http, följt av tunneling-proxyanvändarnamnet och lösenordet (dvs. användarnamnet och lösenordet som visas i kontrollpanelen, separerade med kolon), följt av ett `@`-tecken och sedan proxyadressen och porten. > Observera: Du behöver ersätta `{proxy_username}:{proxy_password}` i ovanstående kod med ditt proxyanvändarnamn och lösenord, det slutliga resultatet liknar `proxy = 'http://1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007'`, observera att det inte finns några `{` och `}` tecken. Därefter deklareras en proxies-variabel som konfigurerar två nyckel-värde-par, där nycklarna är http och https, och deras värden är proxy, vilket representerar att för webbplatser med HTTP- och HTTPS-protokoll används proxy-variabeln för att göra begäran. Sedan definieras en loop som körs tre gånger för att testa proxy. Resultatet ser ut som följer: ```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" } ``` Som du kan se är proxy-IP:n som erhålls vid varje körning slumpmässig, och IP:ns plats kommer verkligen från olika länder och städer runt om i världen. Självklart är den ovanstående proxyinställningsmetoden faktiskt en relativt enkel inställning. Faktiskt är den ovanstående koden ekvivalent med att ställa in en extra header - Proxy Authorization vid begäran, så den ovanstående koden kan också skrivas om som följer: ```python theme={null} import requests import base64 proxy_host = 'global.proxy.xhuoapi.ai' proxy_port = '30007' proxy_username = '{proxy_username}' # 8 tecken användarnamn proxy_password = '{proxy_password}' # 32 tecken lösenord 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) ``` Som du kan se har vi här genom headern Proxy-Authorization ställt in proxyanvändarnamnet och lösenordet (som behöver Base64-kodas), och den här kodens körningseffekt är densamma. För andra språk, som JavaScript:s axios, kan en liknande inställningsmetod också användas: ```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 tecken användarnamn const proxy_password = "{proxy_password}"; // 32 tecken lösenord 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)); } ``` Körningseffekten är densamma. För inställningsmetoder för andra språk, vänligen referera till ovanstående och skriv om det själv. ## Regionsfilter Vi kan filtrera regioner genom att lägga till region i användarnamnet, till exempel om vi vill välja en proxy i USA, det ursprungliga användarnamnet är `1f78266a`, då kan vi ändra användarnamnet till `1f78266a-region-us`, ovanstående curl kan skrivas om som följer: ``` curl -x 1f78266a-region-us:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Regionslista: | Land eller region namn | Land/region kod | | ------------------------------ | --------------- | | USA | us | | Hongkong | hk | | Andorra | ad | | Förenade Arabemiraten | ae | | Afghanistan | af | | Antigua och Barbuda | ag | | Anguilla | ai | | Albanien | al | | Armenien | am | | Angola | ao | | Antarktis | aq | | Argentina | ar | | Amerikanska Samoa | as | | Österrike | at | | Australien | au | | Aruba | aw | | Ålandöarna | ax | | Azerbajdzjan | az | | Bosnien och Hercegovina | ba | | Barbados | bb | | Bangladesh | bd | | Belgien | be | | Burkina Faso | bf | | Bulgarien | bg | | Bahrain | bh | | Burundi | bi | | Benin | bj | | Saint Barthélemy | bl | | Bermuda | bm | | Brunei | bn | | Bolivia | bo | | Nederländska Karibien | bq | | Brasilien | br | | Bahamas | bs | | Bhutan | bt | | Bouvetön | bv | | Botswana | bw | | Vitryssland | by | | Belize | bz | | Kanada | ca | | Kokosöarna | cc | | Centralafrikanska republiken | cf | | Schweiz | ch | | Chile | cl | | Kamerun | cm | | Colombia | co | | Costa Rica | cr | | Kuba | cu | | Kap Verde | cv | | Julön | cx | | Cypern | cy | | Tjeckien | cz | | Tyskland | de | | Djibouti | dj | | Danmark | dk | | Dominikanska republiken | dm | | Dominikanska republiken | do | | Algeriet | dz | | Ecuador | ec | | Estland | ee | | Egypten | eg | | Västsahara | eh | | Eritrea | er | | Spanien | es | | Finland | fi | | Fiji | fj | | Mikronesiska federationen | fm | | Färöarna | fo | | Frankrike | fr | | Gabon | ga | | Grenada | gd | | Georgien | ge | | Franska Guyana | gf | | Ghana | gh | | Gibraltar | gi | | Grönland | gl | | Guinea | gn | | Guadeloupe | gp | | Ekvatorialguinea | gq | | Grekland | gr | | Guatemala | gt | | Guam | gu | | Guinea-Bissau | gw | | Guyana | gy | | Heardön och McDonaldöarna | hm | | Honduras | hn | | Kroatien | hr | | Haiti | ht | | Ungern | hu | | Indonesien | id | | Irland | ie | | Israel | il | | Isle of Man | im | | Indien | in | | Brittiska Indiska Oceanen | io | | Irak | iq | | Iran | ir | | Island | is | | Italien | it | | Jersey | je | | Jamaica | jm | | Jordanien | jo | | Japan | jp | | Kambodja | kh | | Kiribati | ki | | Komorerna | km | | Kuwait | kw | | Caymanöarna | ky | | Libanon | lb | | Liechtenstein | li | | Sri Lanka | lk | | Liberia | lr | | Lesotho | ls | | Litauen | lt | | Luxemburg | lu | | Lettland | lv | | Libyen | ly | | Marocko | ma | | Monaco | mc | | Moldavien | md | | Montenegro | me | | Franska Saint Martin | mf | | Madagaskar | mg | | Marshallöarna | mh | | Nordmakedonien | mk | | Mali | ml | | Myanmar | mm | | Macao | mo | | Martinique | mq | | Mauretanien | mr | | Montserrat | ms | | Malta | mt | | Maldiverna | mv | | Malawi | mw | | Mexiko | mx | | Malaysia | my | | Namibia | na | | Niger | ne | | Norfolkön | nf | | Nigeria | ng | | Nicaragua | ni | | Nederländerna | nl | | Norge | no | | Nepal | np | | Nauru | nr | | Oman | om | | Panama | pa | | Peru | pe | | Franska Polynesien | pf | | Papua Nya Guinea | pg | | Filippinerna | ph | | Pakistan | pk | | Polen | pl | | Pitcairnöarna | pn | | Puerto Rico | pr | | Palestina | ps | | Palau | pw | | Paraguay | py | | Qatar | qa | | Réunion | re | | Rumänien | ro | | Serbien | rs | | Ryssland | ru | | Rwanda | rw | | Salomonöarna | sb | | Seychellerna | sc | | Sudan | sd | | Sverige | se | | Singapore | sg | | Slovenien | si | | Slovakien | sk | | Sierra Leone | sl | | San Marino | sm | | Senegal | sn | | Somalia | so | | Surinam | sr | | Sydsudan | ss | | São Tomé och Príncipe | st | | El Salvador | sv | | Syrien | sy | | Eswatini | sz | | Turks- och Caicosöarna | tc | | Tchad | td | | Togo | tg | | Thailand | th | | Tokelau | tk | | Östtimor | tl | | Tunisien | tn | | Tonga | to | | Turkiet | tr | | Tuvalu | tv | | Tanzania | tz | | Ukraina | ua | | Uganda | ug | | Uruguay | uy | | Vatikanstaten | va | | Venezuela | ve | | Brittiska Jungfruöarna | vg | | Amerikanska Jungfruöarna | vi | | Vietnam | vn | | Wallis och Futuna | wf | | Samoa | ws | | Jemen | ye | | Mayotte | yt | | Sydafrika | za | | Zambia | zm | | Zimbabwe | zw | | Kongo (Brazzaville) | cg | | Kongo (Kinshasa) | cd | | Moçambique | mz | | Guernsey | gg | | Gambia | gm | | Norra Marianaöarna | mp | | Etiopien | et | | Nya Kaledonien | nc | | Vanuatu | vu | | Franska södra territorier | tf | | Niue | nu | | Amerikanska småöar | um | | Cooköarna | ck | | Storbritannien | gb | | Trinidad och Tobago | tt | | Saint Vincent och Grenadinerna | vc | | **###** | tw | | Nya Zeeland | nz | | Saudiarabien | sa | | Laos | la | | Nordkorea | kp | | Sydkorea | kr | | Portugal | pt | | Kirgizistan | kg | | Kazakstan | kz | | Tadzjikistan | tj | | Turkmenistan | tm | | Uzbekistan | uz | | Saint Kitts och Nevis | kn | | Saint Pierre och Miquelon | pm | | Saint Helena | sh | | Saint Lucia | lc | | Mauritius | mu | | Elfenbenskusten | ci | | Kenya | ke | | Mongoliet | mn | ## IP Fast Som ovanstående innehåll kan vi genom att lägga till `session` i användarnamnet och lägga till ett 5-siffrigt fast nummer, uppnå en IP-fast under en viss tid, giltighetstiden är cirka 10 minuter. Till exempel, om du vill uppnå en IP-fast under en viss tid, och det ursprungliga användarnamnet är `1f78266a`, kan du ändra användarnamnet till `1f78266a-session-12345`, där `12345` om det förblir oförändrat, så förblir IP:n oförändrad under en viss tid, ovanstående curl kan skrivas om som följer: ``` curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` ## Köp mer Om ditt paket har tagit slut, behöver du köpa mer för att fortsätta använda den proxy-tjänsten. För att köpa mer, gå till 「[ansökningssidan](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)」 och klicka direkt på knappen 「Köp mer」 för att välja, ju mer du köper på en gång, desto billigare blir enhetspriset.