> ## 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 주소와 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));
}
```

실행 결과는 모두 동일합니다.

다른 언어의 설정 방법에 대해서는 위 내용을 참고하여 스스로 수정하시면 됩니다.

## 지역 필터링

우리는 username에 region을 추가하여 지역 필터링을 할 수 있습니다. 예를 들어 미국의 프록시를 선택하고 싶다면 원래의 username이 `1f78266a`라면 username을 `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 고정

위의 내용과 마찬가지로, username에 `session`을 추가하고 5자리 고정 숫자를 추가하여 일정 시간 동안 IP 고정을 구현할 수 있으며, 유효 기간은 약 10분입니다.

예를 들어 일정 시간 동안 IP 고정을 구현하려면 원래의 username이 `1f78266a`인 경우, username을 `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)」로 가서 「더 구매하기」 버튼을 클릭하여 선택하면 되며, 단일 구매 시 단가가 더 저렴합니다.