Início rápido

Faça sua primeira requisição via proxy em menos de um minuto.

1. Crie uma conta e escolha um plano

   Cadastre-se em shifter.io/order e escolha um plano.

2. Obtenha suas credenciais

   Abra o painel do cliente e copie seu username e password do proxy (ou a chave de API para as APIs de Scraping/SERP). Elas se parecem com:

   Username: customer-USERNAME
   Password: 5f8a9c2b1d3e4f6g7h8i
   Gateway:  p.shifter.io:443

3. Envie sua primeira requisição

   Roteie qualquer chamada HTTP através do gateway. O username codifica seu targeting:

   curl

   curl -x customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
     https://ipinfo.io/json

   Python

   import requests
   
   proxy = "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443"
   proxies = {"http": proxy, "https": proxy}
   
   r = requests.get("https://ipinfo.io/json", proxies=proxies)
   print(r.text)

   Node.js

   import fetch from 'node-fetch';
   import { HttpsProxyAgent } from 'https-proxy-agent';
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   const res = await fetch('https://ipinfo.io/json', { agent });
   console.log(await res.text());

   TypeScript

   import axios from 'axios';
   import { HttpsProxyAgent } from 'https-proxy-agent';
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   const { data } = await axios.get<string>('https://ipinfo.io/json', {
     httpAgent: agent,
     httpsAgent: agent,
   });
   
   console.log(data);

   JavaScript

   const fetch = require('node-fetch');
   const { HttpsProxyAgent } = require('https-proxy-agent');
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   fetch('https://ipinfo.io/json', { agent })
     .then((r) => r.text())
     .then(console.log);

   Go

   package main
   
   import (
     "fmt"
     "io"
     "net/http"
     "net/url"
   )
   
   func main() {
     proxyURL, _ := url.Parse("customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443")
     client := &http.Client{
       Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
     }
   
     resp, _ := client.Get("https://ipinfo.io/json")
     defer resp.Body.Close()
     body, _ := io.ReadAll(resp.Body)
     fmt.Println(string(body))
   }

   Rust

   use reqwest::blocking::Client;
   use reqwest::Proxy;
   
   fn main() -> Result<(), Box<dyn std::error::Error>> {
       let proxy = Proxy::all("http://p.shifter.io:443")?
           .basic_auth("customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600", "PASSWORD");
   
       let client = Client::builder().proxy(proxy).build()?;
       let body = client.get("https://ipinfo.io/json").send()?.text()?;
       println!("{body}");
       Ok(())
   }

   Java

   import java.net.*;
   import java.net.http.*;
   
   public class Main {
       public static void main(String[] args) throws Exception {
           HttpClient client = HttpClient.newBuilder()
               .proxy(ProxySelector.of(new InetSocketAddress("p.shifter.io", 443)))
               .authenticator(new Authenticator() {
                   protected PasswordAuthentication getPasswordAuthentication() {
                       return new PasswordAuthentication(
                           "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600",
                           "PASSWORD".toCharArray()
                       );
                   }
               })
               .build();
   
           HttpRequest req = HttpRequest.newBuilder(URI.create("https://ipinfo.io/json")).build();
           HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
           System.out.println(res.body());
       }
   }

   C#

   using System.Net;
   using System.Net.Http;
   
   var handler = new HttpClientHandler
   {
       Proxy = new WebProxy("http://p.shifter.io:443")
       {
           Credentials = new NetworkCredential(
               "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600",
               "PASSWORD"
           )
       },
       UseProxy = true
   };
   
   using var client = new HttpClient(handler);
   var ip = await client.GetStringAsync("https://ipinfo.io/json");
   Console.WriteLine(ip);

   PHP

   <?php
   require 'vendor/autoload.php';
   
   $client = new GuzzleHttp\Client([
       'proxy' => 'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443',
   ]);
   
   $res = $client->get('https://ipinfo.io/json');
   echo $res->getBody();

4. Escolha um país, sessão ou ISP

   Use parâmetros para controlar geolocalização, sessão e roteamento:

   Parâmetro	Exemplo	Efeito
   country-XX	customer-USERNAME-country-de	Roteia através da Alemanha
   region-NAME	customer-USERNAME-region-california	Direciona para uma região/estado específico
   city-NAME	customer-USERNAME-city-new_york	Direciona para uma cidade específica
   asn-NUMBER	customer-USERNAME-asn-7922	Direciona para um ASN específico
   sid-ID	customer-USERNAME-sid-abc	Sessão fixa (mesmo IP mantido pelo TTL padrão de 120s)
   ttl-SECONDS	customer-USERNAME-sid-abc-ttl-600	TTL personalizado em segundos para a sessão fixa (requer sid)
   strict-true	customer-USERNAME-country-us-strict-true	Falha com 502 em vez de recorrer a um pool mais amplo

Próximos passos

• Autenticação - chaves de API vs. username/password
• Escolhendo um produto - escolha o produto Shifter certo
• Referência da API - todos os endpoints REST, todos os parâmetros