Saltar para o conteúdo principal
Este documento apresenta as instruções de integração com o agente global da Ace Data Cloud, 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」 para fazer a solicitação, a primeira solicitação tem um crédito gratuito de 1 ponto. 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: 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: 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.acedata.cloud 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/ 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: 
curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud: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, 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: 
{
  "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: 
import requests

proxy = 'http://{proxy_username}:{proxy_password}@global.proxy.acedata.cloud: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.acedata.cloud: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: 
{
  "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: 
import requests
import base64

proxy_host = 'global.proxy.acedata.cloud'
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: 
const axios = require("axios");
const base64 = require("base64");

const proxy_host = "global.proxy.acedata.cloud";
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.acedata.cloud:30007 https://ipinfo.io
Lista de regiões:
Nome do país ou regiãoCódigo do país/região
Estados Unidosus
Hong Konghk
Andorraad
Emirados Árabes Unidosae
Afeganistãoaf
Antígua e Barbudaag
Anguillaai
Albâniaal
Armêniaam
Angolaao
Antárticaaq
Argentinaar
Samoa Americanaas
Áustriaat
Austráliaau
Arubaaw
Ilhas Ålandax
Azerbaijãoaz
Bósnia e Herzegovinaba
Barbadosbb
Bangladeshbd
Bélgicabe
Burkina Fasobf
Bulgáriabg
Bahreinbh
Burundibi
Beninbj
São Bartolomeubl
Bermudasbm
Bruneibn
Bolíviabo
Caribe Neerlandêsbq
Brasilbr
Bahamasbs
Butãobt
Ilha Bouvetbv
Botsuanabw
Bielorrússiaby
Belizebz
Canadáca
Ilhas Cocoscc
República Centro-Africanacf
Suíçach
Chilecl
Camarõescm
Colômbiaco
Costa Ricacr
Cubacu
Cabo Verdecv
Ilha Christmascx
Chiprecy
República Tchecacz
Alemanhade
Djibutidj
Dinamarcadk
Dominicadm
República Dominicanado
Argéliadz
Equadorec
Estôniaee
Egitoeg
Saara Ocidentaleh
Eritreiaer
Espanhaes
Finlândiafi
Ilhas Fijifj
Estados Federados da Micronésiafm
Ilhas Faroefo
Françafr
Gabãoga
Granadagd
Geórgiage
Guiana Francesagf
Ganagh
Gibraltargi
Groenlândiagl
Guinégn
Guadalupegp
Guiné Equatorialgq
Gréciagr
Guatemalagt
Guamgu
Guiné-Bissaugw
Guianagy
Ilhas Heard e McDonaldhm
Hondurashn
Croáciahr
Haitiht
Hungriahu
Indonésiaid
Irlandaie
Israelil
Ilha de Manim
Índiain
Território Britânico do Oceano Índicoio
Iraqueiq
Irãir
Islândiais
Itáliait
Ilha de Jerseyje
Jamaicajm
Jordâniajo
Japãojp
Cambojakh
Quiribáski
Comoreskm
Kuwaitkw
Ilhas Caymanky
Líbanolb
Liechtensteinli
Sri Lankalk
Libérialr
Lesotols
Lituânialt
Luxemburgolu
Letônialv
Líbialy
Marrocosma
Mônacomc
Moldáviamd
Montenegrome
São Martinhomf
Madagascarmg
Ilhas Marshallmh
Macedôniamk
Maliml
Mianmarmm
Macaumo
Martinicamq
Mauritâniamr
Ilha de Montserratms
Maltamt
Maldivasmv
Maláuimw
Méxicomx
Malásiamy
Namíbiana
Nígerne
Ilha Norfolknf
Nigériang
Nicaráguani
Países Baixosnl
Noruegano
Nepalnp
Naurunr
Omãom
Panamápa
Perupe
Polinésia Francesapf
Papua Nova Guinépg
Filipinasph
Paquistãopk
Polôniapl
Ilhas Pitcairnpn
Porto Ricopr
Palestinaps
Palaupw
Paraguaipy
Catarqa
Reuniãore
Romêniaro
Sérviars
Rússiaru
Ruandarw
Ilhas Salomãosb
Seichelessc
Sudãosd
Suéciase
Cingapurasg
Eslovêniasi
Eslováquiask
Serra Leoasl
San Marinosm
Senegalsn
Somáliaso
Surinamesr
Sudão do Sulss
São Tomé e Príncipest
El Salvadorsv
Síriasy
Essuatínisz
Ilhas Turks e Caicostc
Chadetd
Togotg
Tailândiath
Tokelautk
Timor-Lestetl
Tunísiatn
Tongato
Turquiatr
Tuvalutv
Tanzâniatz
Ucrâniaua
Ugandaug
Uruguaiuy
Vaticanova
Venezuelave
Ilhas Virgens Britânicasvg
Ilhas Virgens Americanasvi
Vietnãvn
Wallis e Futunawf
Samoaws
Iémenye
Mayotteyt
África do Sulza
Zâmbiazm
Zimbábuezw
Congo (Brazzaville)cg
Congo (Kinshasa)cd
Moçambiquemz
Ilha de Guernseygg
Gâmbiagm
Ilhas Marianas do Nortemp
Etiópiaet
Nova Caledônianc
Vanuatuvu
Territórios do Sul da Françatf
Niuenu
Ilhas Menores dos EUAum
Ilhas Cookck
Reino Unidogb
Trinidad e Tobagott
São Vicente e Granadinasvc
###tw
Nova Zelândianz
Arábia Sauditasa
Laosla
Coreia do Nortekp
Coreia do Sulkr
Portugalpt
Quirguistãokg
Cazaquistãokz
Tajiquistãotj
Turcomenistãotm
Uzbequistãouz
São Cristóvão e Néviskn
São Pedro e Miquelonpm
Santa Helenash
Santa Lúcialc
Mauríciomu
Costa do Marfimci
Quêniake
Mongóliamn

​
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.acedata.cloud: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」 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.