> ## 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. # Istruzioni per l'integrazione degli agenti globali > Global Rotation Agent 集成指南 - XHuoAPI Questo documento introduce principalmente le istruzioni per l'integrazione degli agenti globali di XHuoAPI, comprese le modalità di richiesta, le modalità pratiche e altri contenuti specifici. ## Modalità di richiesta Per utilizzare i servizi globali, è possibile prima andare alla 「[pagina di richiesta](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)」 per effettuare la richiesta, la prima richiesta ha un credito gratuito di 1 punto. ![](https://cdn.xhuoapi.ai/cyzvmz.png) Se non si è ancora effettuato il login, si verrà automaticamente reindirizzati alla pagina di login, dopo aver effettuato il login si può continuare con la richiesta. ## Modalità di utilizzo Dopo aver completato la richiesta, è possibile controllare il risultato della propria richiesta nella 「console」, come mostrato nell'immagine: ![](https://cdn.xhuoapi.ai/y9boi5.png) Cliccando su 「Credentials」, è possibile visualizzare il nome utente e la password per utilizzare il servizio dell'agente globale, separati da due punti, dove il nome utente è di 8 caratteri e la password è di 32 caratteri, come mostrato nell'immagine: ![](https://cdn.xhuoapi.ai/ixwm85.png) Questo agente è un agente rotante (Rotating Proxy), quindi durante l'uso è sufficiente impostare un indirizzo e una porta dell'agente fissi, l'indirizzo e la porta dell'agente sono rispettivamente `global.proxy.xhuoapi.ai` e `30007`, questo agente è un proxy per i protocolli HTTP/HTTPS/SOCKS, può essere utilizzato per richiedere siti web che utilizzano i protocolli HTTP e HTTPS. > Nota: Questo agente può essere utilizzato solo in ambienti di rete al di fuori della Cina, non è utilizzabile nella Cina continentale. ## Test dei comandi Una volta ottenuti il nome utente e la password dell'agente, il modo più semplice per testare è utilizzare il comando curl, se non è installato, si prega di fare riferimento a [https://curl.se/](https://curl.se/) per l'installazione. Se il nome utente e la password attuali dell'agente sono `1f78266a:eff0896726224fa2a99fe82dd1f07562`, possiamo utilizzare il seguente comando curl per testare: ```shell theme={null} curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Qui utilizziamo il parametro `-x` di curl per specificare l'indirizzo dell'agente, il protocollo dell'agente è di default HTTP/HTTPS, l'URL richiesto è [https://ipinfo.io](https://ipinfo.io), questo sito può restituire l'indirizzo IP reale della richiesta e la regione in cui si trova l'IP. > Nota: Il nome utente e la password sopra potrebbero essere non validi, si prega di sostituirli con il proprio nome utente e password. Il risultato dell'esecuzione è il seguente: ```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" } ``` Si può notare che il campo country restituito è CA, che rappresenta il Canada. Se si esegue nuovamente, si possono ottenere risultati diversi, ogni richiesta ha un'uscita IP casuale. ## Integrazione del codice Di seguito viene mostrato un esempio di come impostare l'agente utilizzando 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) ``` Qui dichiariamo prima l'URL dell'agente e lo definiamo come variabile proxy, il protocollo è HTTP, seguito dal nome utente e dalla password dell'agente (cioè il nome utente e la password mostrati nella console, separati da due punti), seguito da un simbolo `@`, e poi dall'indirizzo e dalla porta dell'agente. > Nota: È necessario sostituire `{proxy_username}:{proxy_password}` nel codice sopra con il proprio nome utente e password dell'agente, il risultato finale sarà simile a `proxy = 'http://1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007'`, si prega di notare che non ci sono caratteri `{` e `}`. Successivamente, dichiariamo una variabile proxies, configurando due coppie chiave-valore, con i nomi delle chiavi rispettivamente http e https, i cui valori sono entrambi proxy, rappresentando che per i siti web che utilizzano i protocolli HTTP e HTTPS, si utilizza l'agente definito dalla variabile proxy per effettuare le richieste. Successivamente, definiamo un ciclo di tre volte per testare l'agente. Il risultato dell'esecuzione è il seguente: ```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" } ``` Si può notare che ogni volta che si esegue il risultato, l'IP dell'agente è casuale e la regione dell'IP proviene effettivamente da diversi paesi e città del mondo. Naturalmente, il modo di impostare l'agente sopra è in realtà un modo relativamente semplice di configurazione. In realtà, il codice sopra è equivalente a impostare un'intestazione aggiuntiva - Proxy Authorization durante la richiesta, quindi il codice sopra può essere riscritto come segue: ```python theme={null} import requests import base64 proxy_host = 'global.proxy.xhuoapi.ai' proxy_port = '30007' proxy_username = '{proxy_username}' # nome utente di 8 caratteri proxy_password = '{proxy_password}' # password di 32 caratteri 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) ``` Si può notare che qui abbiamo impostato il nome utente e la password dell'agente tramite l'intestazione di richiesta Proxy-Authorization (che deve essere codificata in Base64), l'effetto dell'esecuzione di questo codice è lo stesso. Per altri linguaggi, come JavaScript con axios, è possibile utilizzare un'impostazione simile: ```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}"; // nome utente di 8 caratteri const proxy_password = "{proxy_password}"; // password di 32 caratteri 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)); } ``` L'effetto dell'esecuzione è lo stesso. Per le impostazioni in altre lingue, si prega di fare riferimento al testo sopra e riscrivere di conseguenza. ## Filtraggio per regione Possiamo filtrare per regione aggiungendo la regione nel nome utente, ad esempio, se vogliamo scegliere un proxy degli Stati Uniti, il nome utente originale è `1f78266a`, quindi possiamo modificare il nome utente in `1f78266a-region-us`, il curl sopra può essere riscritto come segue: ``` curl -x 1f78266a-region-us:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Elenco delle regioni: | Nome del paese o della regione | Codice paese/regione | | ----------------------------------------- | -------------------- | | Stati Uniti | us | | Hong Kong | hk | | Andorra | ad | | Emirati Arabi Uniti | ae | | Afghanistan | af | | Antigua e Barbuda | ag | | Anguilla | ai | | Albania | al | | Armenia | am | | Angola | ao | | Antartide | aq | | Argentina | ar | | Samoa Americane | as | | Austria | at | | Australia | au | | Aruba | aw | | Isole Åland | ax | | Azerbaigian | az | | Bosnia ed Erzegovina | ba | | Barbados | bb | | Bangladesh | bd | | Belgio | be | | Burkina Faso | bf | | Bulgaria | bg | | Bahrein | bh | | Burundi | bi | | Benin | bj | | Isola di Saint Barthélemy | bl | | Bermuda | bm | | Brunei | bn | | Bolivia | bo | | Caraibi Olandesi | bq | | Brasile | br | | Bahamas | bs | | Bhutan | bt | | Isola Bouvet | bv | | Botswana | bw | | Bielorussia | by | | Belize | bz | | Canada | ca | | Isole Cocos | cc | | Repubblica Centrafricana | cf | | Svizzera | ch | | Cile | cl | | Camerun | cm | | Colombia | co | | Costa Rica | cr | | Cuba | cu | | Capo Verde | cv | | Isola di Natale | cx | | Cipro | cy | | Repubblica Ceca | cz | | Germania | de | | Gibuti | dj | | Danimarca | dk | | Dominica | dm | | Repubblica Dominicana | do | | Algeria | dz | | Ecuador | ec | | Estonia | ee | | Egitto | eg | | Sahara Occidentale | eh | | Eritrea | er | | Spagna | es | | Finlandia | fi | | Isole Fiji | fj | | Stati Federati di Micronesia | fm | | Isole Faroe | fo | | Francia | fr | | Gabon | ga | | Grenada | gd | | Georgia | ge | | Guyana Francese | gf | | Ghana | gh | | Gibilterra | gi | | Groenlandia | gl | | Guinea | gn | | Guadalupa | gp | | Guinea Equatoriale | gq | | Grecia | gr | | Guatemala | gt | | Guam | gu | | Guinea-Bissau | gw | | Guyana | gy | | Isole Heard e McDonald | hm | | Honduras | hn | | Croazia | hr | | Haiti | ht | | Ungheria | hu | | Indonesia | id | | Irlanda | ie | | Israele | il | | Isola di Man | im | | India | in | | Territorio Britannico dell'Oceano Indiano | io | | Iraq | iq | | Iran | ir | | Islanda | is | | Italia | it | | Isola di Jersey | je | | Giamaica | jm | | Giordania | jo | | Giappone | jp | | Cambogia | kh | | Kiribati | ki | | Comore | km | | Kuwait | kw | | Isole Cayman | ky | | Libano | lb | | Liechtenstein | li | | Sri Lanka | lk | | Liberia | lr | | Lesotho | ls | | Lituania | lt | | Lussemburgo | lu | | Lettonia | lv | | Libia | ly | | Marocco | ma | | Monaco | mc | | Moldavia | md | | Montenegro | me | | Saint Martin Francese | mf | | Madagascar | mg | | Isole Marshall | mh | | Macedonia | mk | | Mali | ml | | Birmania | mm | | Macao | mo | | Martinica | mq | | Mauritania | mr | | Isola di Montserrat | ms | | Malta | mt | | Maldive | mv | | Malawi | mw | | Messico | mx | | Malesia | my | | Namibia | na | | Niger | ne | | Isola Norfolk | nf | | Nigeria | ng | | Nicaragua | ni | | Paesi Bassi | nl | | Norvegia | no | | Nepal | np | | Nauru | nr | | Oman | om | | Panama | pa | | Perù | pe | | Polinesia Francese | pf | | Papua Nuova Guinea | pg | | Filippine | ph | | Pakistan | pk | | Polonia | pl | | Isole Pitcairn | pn | | Porto Rico | pr | | Palestina | ps | | Palau | pw | | Paraguay | py | | Qatar | qa | | Réunion | re | | Romania | ro | | Serbia | rs | | Russia | ru | | Ruanda | rw | | Isole Salomone | sb | | Seychelles | sc | | Sudan | sd | | Svezia | se | | Singapore | sg | | Slovenia | si | | Slovacchia | sk | | Sierra Leone | sl | | San Marino | sm | | Senegal | sn | | Somalia | so | | Suriname | sr | | Sud Sudan | ss | | São Tomé e Príncipe | st | | El Salvador | sv | | Siria | sy | | Eswatini | sz | | Isole Turks e Caicos | tc | | Ciad | td | | Togo | tg | | Thailandia | th | | Tokelau | tk | | Timor Est | tl | | Tunisia | tn | | Tonga | to | | Turchia | tr | | Tuvalu | tv | | Tanzania | tz | | Ucraina | ua | | Uganda | ug | | Uruguay | uy | | Vaticano | va | | Venezuela | ve | | Isole Vergini Britanniche | vg | | Isole Vergini Americane | vi | | Vietnam | vn | | Wallis e Futuna | wf | | Samoa | ws | | Yemen | ye | | Mayotte | yt | | Sudafrica | za | | Zambia | zm | | Zimbabwe | zw | | Congo (Brazzaville) | cg | | Congo (Kinshasa) | cd | | Mozambico | mz | | Guernsey | gg | | Gambia | gm | | Isole Marianne Settentrionali | mp | | Etiopia | et | | Nuova Caledonia | nc | | Vanuatu | vu | | Territori Francesi del Sud | tf | | Niue | nu | | Isole Minori degli Stati Uniti | um | | Isole Cook | ck | | Regno Unito | gb | | Trinidad e Tobago | tt | | Saint Vincent e Grenadine | vc | | **###** | tw | | Nuova Zelanda | nz | | Arabia Saudita | sa | | Laos | la | | Corea del Nord | kp | | Corea del Sud | kr | | Portogallo | pt | | Kirghizistan | kg | | Kazakistan | kz | | Tagikistan | tj | | Turkmenistan | tm | | Uzbekistan | uz | | Saint Kitts e Nevis | kn | | Saint Pierre e Miquelon | pm | | Sant'Elena | sh | | Saint Lucia | lc | | Mauritius | mu | | Costa d'Avorio | ci | | Kenya | ke | | Mongolia | mn | ## IP Fisso Come nel contenuto sopra, possiamo ottenere un IP fisso per un certo periodo di tempo aggiungendo `session` nel nome utente e un numero fisso di 5 cifre, con una validità di circa 10 minuti. Ad esempio, se vogliamo ottenere un IP fisso per un certo periodo di tempo, e il nome utente originale è `1f78266a`, possiamo modificare il nome utente in `1f78266a-session-12345`, dove `12345`, se rimane invariato, garantirà che l'IP rimanga lo stesso per un certo periodo. Il comando curl sopra può essere riscritto come segue: ``` curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` ## Acquistare di più Se il tuo piano è esaurito, devi acquistare di più per continuare a utilizzare questo servizio proxy. Per acquistare di più, vai alla «[pagina di richiesta](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)» e clicca direttamente sul pulsante «Acquista di più» per selezionare, più acquisti singoli, più basso sarà il prezzo unitario.