> ## 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. # Instruções de Integração com Agentes Globais > Global Rotation Agent 集成指南 - XHuoAPI Este documento apresenta as instruções de integração com o agente global da XHuoAPI, incluindo métodos de solicitação, métodos práticos e outros conteúdos específicos. ## Método de Solicitação Para usar os serviços globais, você pode primeiro ir à 「[página de solicitação](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)」 para fazer a solicitação, a primeira solicitação tem um crédito gratuito de 1 ponto. ![](https://cdn.xhuoapi.ai/cyzvmz.png) Se você ainda não estiver logado, será redirecionado automaticamente para a página de login; após fazer login, você pode continuar a solicitação. ## Método de Uso Após a solicitação, você pode verificar o resultado da sua solicitação no 「painel de controle」, conforme mostrado na imagem: ![](https://cdn.xhuoapi.ai/y9boi5.png) Clique em 「Credenciais」 para visualizar o nome de usuário e a senha para usar o serviço de agente global, separados por dois pontos, onde o nome de usuário tem 8 caracteres e a senha tem 32 caracteres, conforme mostrado na imagem: ![](https://cdn.xhuoapi.ai/ixwm85.png) Este agente é um proxy rotativo (Rotating Proxy), portanto, ao usá-lo, você só precisa configurar um endereço e porta de proxy fixos, que são `global.proxy.xhuoapi.ai` e `30007`. Este proxy é compatível com os protocolos HTTP/HTTPS/SOCKS e pode ser usado para solicitar sites que utilizam os protocolos HTTP e HTTPS. > Atenção: Este proxy só pode ser usado fora da China; não é utilizável na China continental. ## Teste de Comando Com o nome de usuário e a senha do proxy, a maneira mais conveniente de testar é através do comando curl. Se ainda não estiver instalado, consulte [https://curl.se/](https://curl.se/) para instalação. Supondo que o nome de usuário e a senha do proxy atual sejam `1f78266a:eff0896726224fa2a99fe82dd1f07562`, podemos usar o seguinte comando curl para teste: ```shell theme={null} curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Aqui, usamos o parâmetro `-x` do curl para especificar o endereço do proxy; o protocolo do proxy é, por padrão, HTTP/HTTPS, e a URL solicitada é [https://ipinfo.io](https://ipinfo.io), que pode retornar o endereço IP real e a localização do IP que fez a solicitação. > Atenção: O nome de usuário e a senha acima podem ser inválidos; substitua pelos seus próprios. O resultado da execução é o seguinte: ```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" } ``` Pode-se observar que o campo country do resultado retornado é CA, representando o Canadá. Se você executar novamente, poderá obter um resultado diferente; cada solicitação resulta em um IP de saída aleatório. ## Integração de Código Abaixo, um exemplo em Python demonstrando como configurar o proxy: ```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) ``` Aqui, primeiro declaramos a URL do proxy e a definimos como a variável proxy; o protocolo é HTTP, seguido pelo nome de usuário e senha do proxy (ou seja, o nome de usuário e a senha exibidos no painel, separados por dois pontos), seguido por um símbolo `@`, e depois o endereço e a porta do proxy. > Atenção: Você precisa substituir `{proxy_username}:{proxy_password}` no código acima pelo seu nome de usuário e senha do proxy; o resultado final deve ser semelhante a `proxy = 'http://1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007'`, sem os caracteres `{` e `}`. Em seguida, declaramos uma variável proxies, configurando dois pares chave-valor, com os nomes das chaves sendo http e https, e os valores sendo ambos proxy, representando que para sites que utilizam os protocolos HTTP e HTTPS, ambos usarão o proxy definido na variável proxy para fazer as solicitações. Em seguida, definimos um loop de três vezes para testar o proxy. O resultado da execução é o seguinte: ```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" } ``` Pode-se observar que o IP do proxy obtido a cada execução é aleatório, e a localização do IP realmente provém de diferentes países e cidades ao redor do mundo. Claro, o método de configuração do proxy acima é, na verdade, uma forma relativamente simples de configuração. Na verdade, o código acima é equivalente a definir um cabeçalho adicional - Proxy Authorization - durante a solicitação, portanto, o código acima também pode ser reescrito da seguinte forma: ```python theme={null} import requests import base64 proxy_host = 'global.proxy.xhuoapi.ai' proxy_port = '30007' proxy_username = '{proxy_username}' # nome de usuário de 8 caracteres proxy_password = '{proxy_password}' # senha de 32 caracteres 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) ``` Pode-se observar que aqui, através do cabeçalho de solicitação Proxy-Authorization, configuramos adicionalmente o nome de usuário e a senha do proxy (que precisam ser codificados em Base64), e o efeito da execução desse código é o mesmo. Para outras linguagens, como JavaScript com axios, também é possível usar uma configuração semelhante: ```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 caracteres de nome de usuário const proxy_password = "{proxy_password}"; // 32 caracteres de senha 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)); } ``` O efeito da execução é sempre o mesmo. Para métodos de configuração em outras linguagens, consulte o texto acima e reescreva conforme necessário. ## Filtragem por região Podemos filtrar por região adicionando a região no nome de usuário, por exemplo, se quisermos escolher um proxy dos Estados Unidos, o nome de usuário original é `1f78266a`, então podemos alterar o nome de usuário para `1f78266a-region-us`, o curl acima pode ser reescrito da seguinte forma: ``` curl -x 1f78266a-region-us:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Lista de regiões: | Nome do país ou região | Código do país/região | | ------------------------------------- | --------------------- | | Estados Unidos | us | | Hong Kong | hk | | Andorra | ad | | Emirados Árabes Unidos | ae | | Afeganistão | af | | Antígua e Barbuda | ag | | Anguilla | ai | | Albânia | al | | Armênia | am | | Angola | ao | | Antártica | aq | | Argentina | ar | | Samoa Americana | as | | Áustria | at | | Austrália | au | | Aruba | aw | | Ilhas Åland | ax | | Azerbaijão | az | | Bósnia e Herzegovina | ba | | Barbados | bb | | Bangladesh | bd | | Bélgica | be | | Burkina Faso | bf | | Bulgária | bg | | Bahrein | bh | | Burundi | bi | | Benin | bj | | São Bartolomeu | bl | | Bermudas | bm | | Brunei | bn | | Bolívia | bo | | Caribe Neerlandês | bq | | Brasil | br | | Bahamas | bs | | Butão | bt | | Ilha Bouvet | bv | | Botsuana | bw | | Bielorrússia | by | | Belize | bz | | Canadá | ca | | Ilhas Cocos | cc | | República Centro-Africana | cf | | Suíça | ch | | Chile | cl | | Camarões | cm | | Colômbia | co | | Costa Rica | cr | | Cuba | cu | | Cabo Verde | cv | | Ilha Christmas | cx | | Chipre | cy | | República Tcheca | cz | | Alemanha | de | | Djibuti | dj | | Dinamarca | dk | | Dominica | dm | | República Dominicana | do | | Argélia | dz | | Equador | ec | | Estônia | ee | | Egito | eg | | Saara Ocidental | eh | | Eritreia | er | | Espanha | es | | Finlândia | fi | | Ilhas Fiji | fj | | Estados Federados da Micronésia | fm | | Ilhas Faroe | fo | | França | fr | | Gabão | ga | | Granada | gd | | Geórgia | ge | | Guiana Francesa | gf | | Gana | gh | | Gibraltar | gi | | Groenlândia | gl | | Guiné | gn | | Guadalupe | gp | | Guiné Equatorial | gq | | Grécia | gr | | Guatemala | gt | | Guam | gu | | Guiné-Bissau | gw | | Guiana | gy | | Ilhas Heard e McDonald | hm | | Honduras | hn | | Croácia | hr | | Haiti | ht | | Hungria | hu | | Indonésia | id | | Irlanda | ie | | Israel | il | | Ilha de Man | im | | Índia | in | | Território Britânico do Oceano Índico | io | | Iraque | iq | | Irã | ir | | Islândia | is | | Itália | it | | Ilha de Jersey | je | | Jamaica | jm | | Jordânia | jo | | Japão | jp | | Camboja | kh | | Quiribás | ki | | Comores | km | | Kuwait | kw | | Ilhas Cayman | ky | | Líbano | lb | | Liechtenstein | li | | Sri Lanka | lk | | Libéria | lr | | Lesoto | ls | | Lituânia | lt | | Luxemburgo | lu | | Letônia | lv | | Líbia | ly | | Marrocos | ma | | Mônaco | mc | | Moldávia | md | | Montenegro | me | | São Martinho | mf | | Madagascar | mg | | Ilhas Marshall | mh | | Macedônia | mk | | Mali | ml | | Mianmar | mm | | Macau | mo | | Martinica | mq | | Mauritânia | mr | | Ilha de Montserrat | ms | | Malta | mt | | Maldivas | mv | | Maláui | mw | | México | mx | | Malásia | my | | Namíbia | na | | Níger | ne | | Ilha Norfolk | nf | | Nigéria | ng | | Nicarágua | ni | | Países Baixos | nl | | Noruega | no | | Nepal | np | | Nauru | nr | | Omã | om | | Panamá | pa | | Peru | pe | | Polinésia Francesa | pf | | Papua Nova Guiné | pg | | Filipinas | ph | | Paquistão | pk | | Polônia | pl | | Ilhas Pitcairn | pn | | Porto Rico | pr | | Palestina | ps | | Palau | pw | | Paraguai | py | | Catar | qa | | Reunião | re | | Romênia | ro | | Sérvia | rs | | Rússia | ru | | Ruanda | rw | | Ilhas Salomão | sb | | Seicheles | sc | | Sudão | sd | | Suécia | se | | Cingapura | sg | | Eslovênia | si | | Eslováquia | sk | | Serra Leoa | sl | | San Marino | sm | | Senegal | sn | | Somália | so | | Suriname | sr | | Sudão do Sul | ss | | São Tomé e Príncipe | st | | El Salvador | sv | | Síria | sy | | Essuatíni | sz | | Ilhas Turks e Caicos | tc | | Chade | td | | Togo | tg | | Tailândia | th | | Tokelau | tk | | Timor-Leste | tl | | Tunísia | tn | | Tonga | to | | Turquia | tr | | Tuvalu | tv | | Tanzânia | tz | | Ucrânia | ua | | Uganda | ug | | Uruguai | uy | | Vaticano | va | | Venezuela | ve | | Ilhas Virgens Britânicas | vg | | Ilhas Virgens Americanas | vi | | Vietnã | vn | | Wallis e Futuna | wf | | Samoa | ws | | Iémen | ye | | Mayotte | yt | | África do Sul | za | | Zâmbia | zm | | Zimbábue | zw | | Congo (Brazzaville) | cg | | Congo (Kinshasa) | cd | | Moçambique | mz | | Ilha de Guernsey | gg | | Gâmbia | gm | | Ilhas Marianas do Norte | mp | | Etiópia | et | | Nova Caledônia | nc | | Vanuatu | vu | | Territórios do Sul da França | tf | | Niue | nu | | Ilhas Menores dos EUA | um | | Ilhas Cook | ck | | Reino Unido | gb | | Trinidad e Tobago | tt | | São Vicente e Granadinas | vc | | **###** | tw | | Nova Zelândia | nz | | Arábia Saudita | sa | | Laos | la | | Coreia do Norte | kp | | Coreia do Sul | kr | | Portugal | pt | | Quirguistão | kg | | Cazaquistão | kz | | Tajiquistão | tj | | Turcomenistão | tm | | Uzbequistão | uz | | São Cristóvão e Névis | kn | | São Pedro e Miquelon | pm | | Santa Helena | sh | | Santa Lúcia | lc | | Maurício | mu | | Costa do Marfim | ci | | Quênia | ke | | Mongólia | mn | ## IP Fixo Assim como o conteúdo acima, podemos implementar um IP fixo por um período de tempo adicionando `session` ao nome de usuário e incluindo um número fixo de 5 dígitos, com validade de aproximadamente 10 minutos. Por exemplo, se quisermos implementar um IP fixo por um período de tempo, e o nome de usuário original é `1f78266a`, podemos alterar o nome de usuário para `1f78266a-session-12345`, onde `12345`, se não mudar, fará com que o IP permaneça o mesmo por um período de tempo. O curl acima pode ser reescrito da seguinte forma: ``` curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` ## Comprar mais Se o seu plano já se esgotou, você precisará comprar mais para continuar usando o serviço de proxy. Para comprar mais, vá até a 「[página de solicitação](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)」 e clique diretamente no botão 「Comprar mais」 para selecionar, quanto mais você comprar de uma só vez, mais barato será o preço unitário.