> ## 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. # Instrucciones de conexión para agentes globales > Global Rotation Agent 集成指南 - XHuoAPI Este documento presenta principalmente las instrucciones de conexión para el agente global de XHuoAPI, incluyendo métodos de solicitud, métodos prácticos y otros contenidos específicos. ## Método de solicitud Para utilizar el servicio global, primero puede ir a la 「[página de solicitud](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)」 para realizar la solicitud, la primera solicitud tiene un crédito gratuito de 1 punto. ![](https://cdn.xhuoapi.ai/cyzvmz.png) Si aún no ha iniciado sesión, será redirigido automáticamente a la página de inicio de sesión, después de iniciar sesión, puede continuar con la solicitud. ## Método de uso Una vez que haya completado la solicitud, puede ver el resultado de su solicitud en la 「consola」, como se muestra en la imagen: ![](https://cdn.xhuoapi.ai/y9boi5.png) Haga clic en 「Credentials」 para ver el nombre de usuario y la contraseña para usar el servicio de agente global, separados por dos puntos, donde el nombre de usuario tiene 8 caracteres y la contraseña tiene 32 caracteres, como se muestra en la imagen: ![](https://cdn.xhuoapi.ai/ixwm85.png) Este agente es un proxy rotativo (Rotating Proxy), por lo que al usarlo solo necesita configurar una dirección y un puerto de proxy fijos, la dirección y el puerto del proxy son `global.proxy.xhuoapi.ai` y `30007`, este proxy es compatible con los protocolos HTTP/HTTPS/SOCKS y se puede utilizar para solicitar sitios web que utilizan los protocolos HTTP y HTTPS. > Nota: Este proxy solo se puede utilizar en entornos de red fuera de China, no se puede utilizar en la región de China continental. ## Prueba de comandos Una vez que tenga el nombre de usuario y la contraseña del proxy, la forma más conveniente de probarlo es a través del comando curl, si aún no lo ha instalado, consulte [https://curl.se/](https://curl.se/) para la instalación. Si el nombre de usuario y la contraseña del proxy actual son `1f78266a:eff0896726224fa2a99fe82dd1f07562`, podemos usar el siguiente comando curl para realizar la prueba: ```shell theme={null} curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Aquí usamos el parámetro `-x` de curl para especificar la dirección del proxy, el protocolo del proxy es por defecto HTTP/HTTPS, la URL solicitada es [https://ipinfo.io](https://ipinfo.io), este sitio puede devolver la dirección IP real y la ubicación de la IP que solicita el sitio. > Nota: El nombre de usuario y la contraseña mencionados anteriormente pueden ser inválidos, por favor reemplácelos con su nombre de usuario y contraseña. El resultado de la ejecución es el siguiente: ```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" } ``` Se puede ver que el país en el resultado devuelto es CA, lo que representa a Canadá. Si se ejecuta nuevamente, se puede obtener un resultado diferente, cada solicitud tiene una salida de IP aleatoria. ## Conexión de código A continuación, se muestra un ejemplo de cómo configurar este proxy en 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) ``` Aquí primero declaramos la URL del proxy y la definimos como la variable proxy, el protocolo es HTTP, seguido del nombre de usuario y la contraseña del proxy (es decir, el nombre de usuario y la contraseña mostrados en la consola, separados por dos puntos), seguido de un símbolo `@`, y luego la dirección y el puerto del proxy. > Nota: Debe reemplazar `{proxy_username}:{proxy_password}` en el código anterior con su nombre de usuario y contraseña del proxy, el resultado final será similar a `proxy = 'http://1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007'`, tenga en cuenta que no hay caracteres `{` y `}`. Luego, declaramos una variable proxies, configuramos dos pares clave-valor, donde los nombres de las claves son http y https, y sus valores son proxy, lo que representa que para los sitios web que utilizan los protocolos HTTP y HTTPS, se utiliza el proxy definido en la variable proxy para realizar las solicitudes. A continuación, definimos un bucle de tres veces para realizar la prueba del proxy. El resultado de la ejecución es el siguiente: ```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" } ``` Se puede ver que cada vez que se ejecuta, el IP del proxy obtenido es aleatorio, y la ubicación de la IP proviene de diferentes países y ciudades del mundo. Por supuesto, el método de configuración del proxy mencionado anteriormente es en realidad una forma de configuración relativamente simple. En realidad, el código anterior es equivalente a establecer un encabezado adicional en la solicitud - Proxy Authorization, por lo que el código anterior también se puede reescribir de la siguiente manera: ```python theme={null} import requests import base64 proxy_host = 'global.proxy.xhuoapi.ai' proxy_port = '30007' proxy_username = '{proxy_username}' # nombre de usuario de 8 caracteres proxy_password = '{proxy_password}' # contraseña 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) ``` Se puede ver que aquí hemos configurado el nombre de usuario y la contraseña del proxy a través del encabezado de solicitud Proxy-Authorization (que necesita ser codificado en Base64), el efecto de ejecución de este código es el mismo. Para otros lenguajes, como JavaScript con axios, también se puede utilizar un método de configuración similar: ```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)); } ``` El efecto de ejecución es el mismo. Para la configuración en otros idiomas, consulte el texto anterior y modifíquelo según sea necesario. ## Filtrado por región Podemos filtrar por región agregando la región en el nombre de usuario, por ejemplo, si queremos seleccionar un proxy de Estados Unidos, el nombre de usuario original es `1f78266a`, entonces podemos cambiar el nombre de usuario a `1f78266a-region-us`, el curl anterior se puede reescribir de la siguiente manera: ``` curl -x 1f78266a-region-us:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Lista de regiones: | Nombre del país o región | Código del país/región | | -------------------------------------- | ---------------------- | | Estados Unidos | us | | Hong Kong | hk | | Andorra | ad | | Emiratos Árabes Unidos | ae | | Afganistán | af | | Antigua y Barbuda | ag | | Anguila | ai | | Albania | al | | Armenia | am | | Angola | ao | | Antártida | aq | | Argentina | ar | | Samoa Americana | as | | Austria | at | | Australia | au | | Aruba | aw | | Islas Åland | ax | | Azerbaiyán | az | | Bosnia y Herzegovina | ba | | Barbados | bb | | Bangladés | bd | | Bélgica | be | | Burkina Faso | bf | | Bulgaria | bg | | Baréin | bh | | Burundi | bi | | Benín | bj | | Isla de San Bartolomé | bl | | Bermudas | bm | | Brunéi | bn | | Bolivia | bo | | Caribe Neerlandés | bq | | Brasil | br | | Bahamas | bs | | Bután | bt | | Isla Bouvet | bv | | Botsuana | bw | | Bielorrusia | by | | Belice | bz | | Canadá | ca | | Islas Cocos | cc | | República Centroafricana | cf | | Suiza | ch | | Chile | cl | | Camerún | cm | | Colombia | co | | Costa Rica | cr | | Cuba | cu | | Cabo Verde | cv | | Isla de Navidad | cx | | Chipre | cy | | Chequia | cz | | Alemania | de | | Yibuti | dj | | Dinamarca | dk | | Dominica | dm | | República Dominicana | do | | Argelia | dz | | Ecuador | ec | | Estonia | ee | | Egipto | eg | | Sáhara Occidental | eh | | Eritrea | er | | España | es | | Finlandia | fi | | Islas Fiyi | fj | | Estados Federados de Micronesia | fm | | Islas Feroe | fo | | Francia | fr | | Gabón | ga | | Granada | gd | | Georgia | ge | | Guayana Francesa | gf | | Ghana | gh | | Gibraltar | gi | | Groenlandia | gl | | Guinea | gn | | Guadalupe | gp | | Guinea Ecuatorial | gq | | Grecia | gr | | Guatemala | gt | | Guam | gu | | Guinea-Bisáu | gw | | Guyana | gy | | Isla Heard y McDonald | hm | | Honduras | hn | | Croacia | hr | | Haití | ht | | Hungría | hu | | Indonesia | id | | Irlanda | ie | | Israel | il | | Isla de Man | im | | India | in | | Territorio Británico del Océano Índico | io | | Irak | iq | | Irán | ir | | Islandia | is | | Italia | it | | Isla de Jersey | je | | Jamaica | jm | | Jordania | jo | | Japón | jp | | Camboya | kh | | Kiribati | ki | | Comoras | km | | Kuwait | kw | | Islas Caimán | ky | | Líbano | lb | | Liechtenstein | li | | Sri Lanka | lk | | Liberia | lr | | Lesoto | ls | | Lituania | lt | | Luxemburgo | lu | | Letonia | lv | | Libia | ly | | Marruecos | ma | | Mónaco | mc | | Moldavia | md | | Montenegro | me | | San Martín Francés | mf | | Madagascar | mg | | Islas Marshall | mh | | Macedonia | mk | | Malí | ml | | Birmania | mm | | Macao | mo | | Martinica | mq | | Mauritania | mr | | Isla de Montserrat | ms | | Malta | mt | | Maldivas | mv | | Malaui | mw | | México | mx | | Malasia | my | | Namibia | na | | Níger | ne | | Isla Norfolk | nf | | Nigeria | ng | | Nicaragua | ni | | Países Bajos | nl | | Noruega | no | | Nepal | np | | Nauru | nr | | Omán | om | | Panamá | pa | | Perú | pe | | Polinesia Francesa | pf | | Papúa Nueva Guinea | pg | | Filipinas | ph | | Pakistán | pk | | Polonia | pl | | Islas Pitcairn | pn | | Puerto Rico | pr | | Palestina | ps | | Palaos | pw | | Paraguay | py | | Catar | qa | | Reunión | re | | Rumanía | ro | | Serbia | rs | | Rusia | ru | | Ruanda | rw | | Islas Salomón | sb | | Seychelles | sc | | Sudán | sd | | Suecia | se | | Singapur | sg | | Eslovenia | si | | Eslovaquia | sk | | Sierra Leona | sl | | San Marino | sm | | Senegal | sn | | Somalia | so | | Surinam | sr | | Sudán del Sur | ss | | Santo Tomé y Príncipe | st | | El Salvador | sv | | Siria | sy | | Suazilandia | sz | | Islas Turcas y Caicos | tc | | Chad | td | | Togo | tg | | Tailandia | th | | Tokelau | tk | | Timor Oriental | tl | | Túnez | tn | | Tonga | to | | Turquía | tr | | Tuvalu | tv | | Tanzania | tz | | Ucrania | ua | | Uganda | ug | | Uruguay | uy | | Ciudad del Vaticano | va | | Venezuela | ve | | Islas Vírgenes Británicas | vg | | Islas Vírgenes de los Estados Unidos | vi | | Vietnam | vn | | Wallis y Futuna | wf | | Samoa | ws | | Yemen | ye | | Mayotte | yt | | Sudáfrica | za | | Zambia | zm | | Zimbabue | zw | | Congo (Brazzaville) | cg | | Congo (Kinshasa) | cd | | Mozambique | mz | | Isla de Guernsey | gg | | Gambia | gm | | Islas Marianas del Norte | mp | | Etiopía | et | | Nueva Caledonia | nc | | Vanuatu | vu | | Territorios Australes Franceses | tf | | Niue | nu | | Islas Menores de los Estados Unidos | um | | Islas Cook | ck | | Reino Unido | gb | | Trinidad y Tobago | tt | | San Vicente y las Granadinas | vc | | **###** | tw | | Nueva Zelanda | nz | | Arabia Saudita | sa | | Laos | la | | Corea del Norte | kp | | Corea del Sur | kr | | Portugal | pt | | Kirguistán | kg | | Kazajistán | kz | | Tayikistán | tj | | Turkmenistán | tm | | Uzbekistán | uz | | San Cristóbal y Nieves | kn | | San Pedro y Miquelón | pm | | Santa Elena | sh | | Santa Lucía | lc | | Mauricio | mu | | Costa de Marfil | ci | | Kenia | ke | | Mongolia | mn | ## IP Fijo Al igual que el contenido anterior, podemos lograr un IP fijo durante un tiempo determinado añadiendo `session` en el nombre de usuario y un número fijo de 5 dígitos, con una validez de aproximadamente 10 minutos. Por ejemplo, si queremos lograr un IP fijo durante un tiempo, y el nombre de usuario original es `1f78266a`, podemos modificar el nombre de usuario a `1f78266a-session-12345`, donde `12345` si no cambia, entonces el IP no cambiará durante un tiempo, el curl anterior se puede reescribir de la siguiente manera: ``` curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` ## Comprar Más Si su paquete ya se ha agotado, necesita comprar más para continuar utilizando el servicio de proxy. Para comprar más, dirígete a la «[página de solicitud](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)» y haz clic directamente en el botón «Comprar más» para seleccionar, la compra única de más, el precio por unidad es más barato.