API para proxies residenciais
Fornecemos proxies residenciais com pagamento por tráfego. Para a API funcionar corretamente, é necessário comprar tráfego de proxies residenciais. Se o seu tráfego acabar, alguns pedidos não funcionarão.
Pedidos à API
É necessária uma chave para utilizar a API. Pode consultá-la na página Perfil.
Formato geral do pedido:
https://thesafety.us/getapi?key=[API ключ]&act=[имя запроса]
Tráfego restante
Para verificar o tráfego restante, utilize act=traffic
https://thesafety.us/getapi?key=[API ключ]&act=traffic
A resposta será no formato XML.
O campo auth = true se a chave API for válida.
O campo resident-traffic-in-mb mostra o tráfego restante em megabytes.
Lista de países, cidades e estados
Pode obter a lista atualizada utilizando act=countries
https://thesafety.us/getapi?key=[API ключ]&act=countries
A resposta será no formato XML.
O campo auth = true se a chave API for válida.
O campo resident contém as etiquetas country (nome completo do país) e code (código do país). Na API deve indicar code (código do país).
Para alguns países, são indicadas cidades na etiqueta city e estados na etiqueta state. As cidades e os estados são apresentados em listas separadas por vírgulas.
Geração de uma lista de proxies
Pode obter a lista de proxies através de act=getresproxy
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy
A resposta será no formato text/plain. Este pedido fornecerá um proxy de qualquer país com um endereço IP dinâmico. O país e o endereço IP serão selecionados aleatoriamente em cada pedido.
Parâmetros adicionais:
| Parâmetro | Comentário |
|---|---|
| &base= | Base de proxies:
Este parâmetro pode ser obtido com o pedido act=countries Se existir apenas uma base de proxies, o parâmetro pode não estar presente. |
| &type= | Tipo de proxy:
http = proxy HTTP/HTTPS socks5 = proxy Socks5 Se type não for indicado, é utilizado http por predefinição. |
| $list= | Formato da lista de proxies:
hpup = hostname:port:username:password hp@up = hostname:port@username:password uphp = username:password:hostname:port up@hp = username:password@hostname:port Se list não for indicado, é utilizado hpup por predefinição. |
| Escolha do país, cidade e estado | |
| &country= | Código de país de 2 letras [parâmetro code do pedido act=countries] |
| &city= | Nome da cidade [parâmetro city do pedido act=countries]
O sistema tentará fornecer endereços IP na localização indicada, mas não há garantia. Não utilize em simultâneo com o parâmetro &state= Funciona apenas se também indicar o país &country= |
| &state= | Nome do estado [parâmetro state do pedido act=countries]
O sistema tentará fornecer endereços IP na localização indicada, mas não há garantia. Não utilize em simultâneo com o parâmetro &city= Funciona apenas se também indicar o país &country= |
| Obtenção de um endereço IP estático | |
| &session=1 | Indica que deve ser utilizado um endereço IP estático, definido na palavra-passe do proxy através do parâmetro session.
Se session não for indicado, é sempre fornecido 1 proxy com um endereço IP dinâmico que muda a cada pedido. A alteração do endereço IP é feita no servidor proxy e não exige configurações adicionais do utilizador. |
| &amount= | Indica a quantidade de proxies a gerar.
Valores possíveis a partir de 1 até 1000. Funciona apenas em conjunto com o parâmetro &session=1 |
| &lifetime= | Tempo após o qual o endereço IP estático é substituído por um novo.
Valores possíveis em segundos, minutos e horas: 5-59s, 1-59m, 1-24h Exemplo: 30s - mudar o endereço IP a cada 30 segundos 10m - mudar o endereço IP a cada 10 minutos 6h - alterar o endereço IP a cada 6 horas O sistema tentará respeitar o parâmetro indicado, mas não o garante.
Funciona apenas em conjunto com o parâmetro &session=1 |
Exemplos de pedidos:
Lista de 10 proxies HTTP/HTTPS com endereço IP estático na Alemanha no formato up@hp
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=de&type=http&list=up@hp&session=1&amount=10
Proxies Socks5 com endereço IP dinâmico nos EUA, no formato hpup
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&type=socks5&list=hpup
Proxy HTTP/HTTPS com endereço IP dinâmico nos EUA, estado do Utah
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&state=utah
Proxy HTTP/HTTPS com endereço IP dinâmico no Canadá, cidade de Montreal
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=ca&city=montreal
Tem sugestões para melhorar a API? Contacte-nos.