> ## 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 ``` Здесь мы используем параметр curl `-x`, чтобы указать адрес прокси, протокол прокси по умолчанию — HTTP/HTTPS, запрашиваемый URL — [https://ipinfo.io](https://ipinfo.io), этот сайт может вернуть реальный 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" } ``` Как видно, возвращаемый результат с полем country — это 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` и добавив 5-значное фиксированное число, срок действия которого составляет примерно 10 минут. Например, если вы хотите зафиксировать IP на некоторое время, исходное имя пользователя `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)» и просто нажмите кнопку «Купить больше», чтобы выбрать, чем больше вы покупаете за раз, тем дешевле цена за единицу.