Integrações de código

O gateway da Shifter fala HTTP(S) e SOCKS5 puro em p.shifter.io:443. Qualquer cliente HTTP(S) em qualquer linguagem que suporte autenticação de proxy vai funcionar, sem necessidade de SDK.

O nome de usuário codifica suas preferências de segmentação e sessão; a senha é a senha da sua conta. Consulte Gateway & auth para a lista completa de flags.

Python

A opção mais popular é requests com um dicionário de proxies:

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)

Para código assíncrono, httpx funciona da mesma forma (httpx.AsyncClient(proxies=proxy)).

Node.js

Use node-fetch (ou o fetch nativo no Node 18+) com https-proxy-agent:

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());

axios, got e undici aceitam todos uma opção de agente semelhante.

TypeScript

O mesmo runtime do Node.js, apenas tipado. Exemplo com axios:

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

Node CommonJS puro, sem transpilador:

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

Biblioteca padrão, sem dependência de terceiros:

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

reqwest com autenticação básica no proxy:

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

java.net.http.HttpClient embutido (Java 11+):

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#

HttpClient com HttpClientHandler.Proxy:

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

Guzzle com a opção de requisição proxy:

<?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();

Bindings curl puros (curl_setopt($ch, CURLOPT_PROXY, '...')) também funcionam.

Precisa de outra coisa?

O gateway é um proxy HTTP/HTTPS/SOCKS puro. Se o seu cliente falar qualquer um desses protocolos com autenticação básica, ele funciona. Para ferramentas específicas de produto (Scrapy, Puppeteer, Playwright, SwitchyOmega, Multilogin), consulte Residential Proxies → Integrações.

Começar

Proxies

APIs

Recursos