> ## 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 Rotation Agent 集成指南 - XHuoAPI Цей документ в основному описує інструкцію з підключення глобального代理 XHuoAPI, включаючи методи подачі заявки, практичні методи тощо. ## Метод подачі заявки Щоб скористатися глобальними послугами, спочатку можна перейти на «[сторінку заявки](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)» для подачі заявки, перша заявка має 1 безкоштовний кредит. ![](https://cdn.xhuoapi.ai/cyzvmz.png) Якщо ви ще не увійшли в систему, вас автоматично перенаправлять на сторінку входу, після входу продовжте подавати заявку. ## Метод використання Після подачі заявки ви можете перейти до «консолі», щоб переглянути результати своєї заявки, як показано на малюнку: ![](https://cdn.xhuoapi.ai/y9boi5.png) Натисніть «Credentials», щоб переглянути ім'я користувача та пароль для використання глобального代理-сервісу, розділені двокрапкою, де ім'я користувача складається з 8 символів, а пароль з 32 символів, як показано на малюнку: ![](https://cdn.xhuoapi.ai/ixwm85.png) Цей代理 є ротаційним代理 (Rotating Proxy), тому під час використання потрібно лише налаштувати одну фіксовану адресу代理 та порт, адреса代理 та порт - це `global.proxy.xhuoapi.ai` та `30007`, цей代理 підтримує протоколи HTTP/HTTPS/SOCKS і може використовуватися для запитів до сайтів, що використовують протоколи HTTP та HTTPS. > Увага: цей代理 можна використовувати лише в мережевому середовищі за межами Китаю, в материковому Китаї він не працює. ## Тестування команд Отримавши ім'я користувача та пароль代理, найзручнішим способом є тестування через командний рядок curl, якщо ви ще не встановили, будь ласка, зверніться до [https://curl.se/](https://curl.se/) для установки. Припустимо, що ім'я користувача та пароль代理 - це `1f78266a:eff0896726224fa2a99fe82dd1f07562`, ми можемо протестувати за допомогою наступної команди curl: ```shell theme={null} curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Тут ми використовуємо параметр `-x` curl для вказівки адреси代理, протокол代理 за замовчуванням - HTTP/HTTPS, URL запиту - [https://ipinfo.io](https://ipinfo.io), цей сайт може повернути реальну IP-адресу та регіон, в якому знаходиться IP. > Увага: вказані ім'я користувача та пароль можуть бути недійсними, будь ласка, замініть їх на свої. Результат виконання виглядає наступним чином: ```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" } ``` Як видно, у повернутому результаті країна - CA, що означає Канаду. Якщо запустити ще раз, можна отримати інший результат, кожен запит має випадкову IP-адресу. ## Інтеграція коду Нижче наведено приклад налаштування цього代理 на 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) ``` Тут ми спочатку оголосили URL代理 і визначили його як змінну proxy, протокол - http, далі йдуть ім'я користувача та пароль тунельного代理 (тобто ім'я користувача та пароль, які відображаються в консолі, розділені двокрапкою), потім йде символ `@`, а потім адреса та порт代理. > Увага: вам потрібно замінити `{proxy_username}:{proxy_password}` у наведеному коді на ваше ім'я користувача та пароль代理, в результаті отримаєте щось на зразок `proxy = 'http://1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007'`, зверніть увагу, що символи `{` і `}` відсутні. Далі оголошується змінна proxies, в якій налаштовано два ключові пари, ключі - http та https, значення обидва - proxy, що означає, що для сайтів, що використовують протоколи HTTP та HTTPS, запити здійснюються через代理, визначений змінною proxy. Далі визначено три цикли для тестування代理. Результат виконання виглядає наступним чином: ```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" } ``` Як видно, результати виконання кожного разу отримують випадкову IP-адресу, і регіон IP дійсно походить з різних країн і міст світу. Звичайно, наведений вище спосіб налаштування代理 насправді є відносно простим способом налаштування. Насправді, наведений вище код еквівалентний налаштуванню додаткового заголовка - Proxy Authorization під час запиту, тому цей код також можна переписати так: ```python theme={null} import requests import base64 proxy_host = 'global.proxy.xhuoapi.ai' proxy_port = '30007' proxy_username = '{proxy_username}' # 8-символьне ім'я користувача proxy_password = '{proxy_password}' # 32-символьний пароль 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) ``` Як видно, тут ми через заголовок Proxy-Authorization додатково налаштували ім'я користувача та пароль代理 (які потрібно закодувати в Base64), такий код також працює так само. Для інших мов, наприклад, JavaScript з axios, також можна використовувати подібний спосіб налаштування: ```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-символьне ім'я користувача const proxy_password = "{proxy_password}"; // 32-символьний пароль 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)); } ``` Результат виконання завжди однаковий. Для налаштування інших мов, будь ласка, зверніться до вищезазначеного та перепишіть самостійно. ## Фільтрація за регіоном Ми можемо здійснити фільтрацію за регіоном, додавши region до імені користувача, наприклад, якщо потрібно вибрати проксі з США, то оригінальне ім'я користувача `1f78266a` можна змінити на `1f78266a-region-us`, тоді curl можна переписати наступним чином: ``` curl -x 1f78266a-region-us:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Список регіонів: | Назва країни або регіону | Код країни/регіону | | ----------------------------------------- | ------------------ | | США | us | | Гонконг | hk | | Андорра | ad | | ОАЕ | ae | | Афганістан | af | | Антигуа і Барбуда | ag | | Ангвілла | ai | | Албанія | al | | Вірменія | am | | Ангола | ao | | Антарктика | aq | | Аргентина | ar | | Американське Самоа | as | | Австрія | at | | Австралія | au | | Аруба | aw | | Аландські острови | ax | | Азербайджан | az | | Боснія і Герцеговина | ba | | Барбадос | bb | | Бангладеш | bd | | Бельгія | be | | Буркіна-Фасо | bf | | Болгарія | bg | | Бахрейн | bh | | Бурунді | bi | | Бенін | bj | | Сен-Бартельмі | bl | | Бермуди | bm | | Бруней | bn | | Болівія | bo | | Нідерландські Антильські острови | bq | | Бразилія | br | | Багамські острови | bs | | Бутан | bt | | Острів Буве | bv | | Ботсвана | bw | | Білорусь | by | | Беліз | bz | | Канада | ca | | Кокосові острови | cc | | Центральноафриканська Республіка | cf | | Швейцарія | ch | | Чилі | cl | | Камерун | cm | | Колумбія | co | | Коста-Ріка | cr | | Куба | cu | | Кабо-Верде | cv | | Острів Різдва | cx | | Кіпр | cy | | Чехія | cz | | Німеччина | de | | Джибуті | dj | | Данія | dk | | Домініка | dm | | Домініканська Республіка | do | | Алжир | dz | | Еквадор | ec | | Естонія | ee | | Єгипет | eg | | Західна Сахара | eh | | Еритрея | er | | Іспанія | es | | Фінляндія | fi | | Фіджі | fj | | Федеративні Штати Мікронезії | fm | | Фарерські острови | fo | | Франція | fr | | Габон | ga | | Гренада | gd | | Грузія | ge | | Французька Гвіана | gf | | Гана | gh | | Гібралтар | gi | | Гренландія | gl | | Гвінея | gn | | Гваделупа | gp | | Екваторіальна Гвінея | gq | | Греція | gr | | Гватемала | gt | | Гуам | gu | | Гвінея-Бісау | gw | | Гаяна | gy | | Острів Херд і острови Макдональд | hm | | Гондурас | hn | | Хорватія | hr | | Гаїті | ht | | Угорщина | hu | | Індонезія | id | | Ірландія | ie | | Ізраїль | il | | Острів Мен | im | | Індія | in | | Британська територія в Індійському океані | io | | Ірак | iq | | Іран | ir | | Ісландія | is | | Італія | it | | Острів Джерсі | je | | Ямайка | jm | | Йорданія | jo | | Японія | jp | | Камбоджа | kh | | Кірібаті | ki | | Комори | km | | Кувейт | kw | | Кайманові острови | ky | | Ліван | lb | | Ліхтенштейн | li | | Шрі-Ланка | lk | | Ліберія | lr | | Лесото | ls | | Литва | lt | | Люксембург | lu | | Латвія | lv | | Лівія | ly | | Марокко | ma | | Монако | mc | | Молдова | md | | Чорногорія | me | | Французький Сен-Мартен | mf | | Мадагаскар | mg | | Маршаллові Острови | mh | | Македонія | mk | | Малі | ml | | М'янма | mm | | Макао | mo | | Мартініка | mq | | Мавританія | mr | | Острів Монсеррат | ms | | Мальта | mt | | Мальдіви | mv | | Малаві | mw | | Мексика | mx | | Малайзія | my | | Намібія | na | | Нігер | ne | | Острів Норфолк | nf | | Нігерія | ng | | Нікарагуа | ni | | Нідерланди | nl | | Норвегія | no | | Непал | np | | Науру | nr | | Оман | om | | Панама | pa | | Перу | pe | | Французька Полінезія | pf | | Папуа Нова Гвінея | pg | | Філіппіни | ph | | Пакистан | pk | | Польща | pl | | Острови Пітермена | pn | | Пуерто-Ріко | pr | | Палестина | ps | | Палау | pw | | Парагвай | py | | Катар | qa | | Реюньйон | re | | Румунія | ro | | Сербія | rs | | Росія | ru | | Руанда | rw | | Соломонові Острови | sb | | Сейшельські Острови | sc | | Судан | sd | | Швеція | se | | Сінгапур | sg | | Словенія | si | | Словаччина | sk | | Сьєрра-Леоне | sl | | Сан-Марино | sm | | Сенегал | sn | | Сомалі | so | | Суринам | sr | | Південний Судан | ss | | Сан-Томе і Принсіпі | st | | Сальвадор | sv | | Сирія | sy | | Свазіленд | sz | | Острови Теркс і Кайкос | tc | | Чад | td | | Того | tg | | Таїланд | th | | Токелау | tk | | Східний Тимор | tl | | Туніс | tn | | Тонга | to | | Туреччина | tr | | Тувалу | tv | | Танзанія | tz | | Україна | ua | | Уганда | ug | | Уругвай | uy | | Ватикан | va | | Венесуела | ve | | Британські Віргінські Острови | vg | | Американські Віргінські Острови | vi | | В'єтнам | vn | | Уолліс і Футуна | wf | | Самоа | ws | | Ємен | ye | | Майотта | yt | | Південноафриканська Республіка | za | | Замбія | zm | | Зімбабве | zw | | Конго (Браззавіль) | cg | | Конго (Кіншаса) | cd | | Мозамбік | mz | | Гернсі | gg | | Гамбія | gm | | Північні Маріанські Острови | mp | | Ефіопія | et | | Нова Каледонія | nc | | Вануату | vu | | Французькі Південні Території | tf | | Ніуе | nu | | Острівні території США | um | | Острови Кука | ck | | Великобританія | gb | | Тринідад і Тобаго | tt | | Сент-Вінсент і Гренадіни | vc | | **###** | tw | | Нова Зеландія | nz | | Саудівська Аравія | sa | | Лаос | la | | Північна Корея | kp | | Південна Корея | kr | | Португалія | pt | | Киргизстан | kg | | Казахстан | kz | | Таджикистан | tj | | Туркменістан | tm | | Узбекистан | uz | | Сент-Кітс і Невіс | kn | | Сен-П'єр і Мікелон | pm | | Острів Святого Єлени | sh | | Сент-Люсія | lc | | Маврикій | mu | | Кот-д'Івуар | ci | | Кенія | ke | | Монголія | mn | ## Фіксація IP Як і в наведеному вище контенті, ми можемо досягти фіксації IP на певний час, додавши `session` до username і додавши 5-значний фіксований номер, термін дії якого приблизно 10 хвилин. Наприклад, якщо ви хочете досягти фіксації IP на певний час, оригінальний username `1f78266a` можна змінити на `1f78266a-session-12345`, де `12345`, якщо не змінюється, то IP залишиться незмінним на певний час, наведений вище curl можна переписати так: ``` curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` ## Купити більше Якщо ваш пакет вже вичерпано, вам потрібно купити більше, щоб продовжити користуватися цим проксі-сервісом. Щоб купити більше, перейдіть на «[сторінку заявки](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)» і просто натисніть кнопку «Купити більше», щоб вибрати, одноразова покупка більше, ціна за одиницю буде дешевшою.