Planos legados de ISP (IPs fixos)

Os planos ISP legados fornecem uma lista fixa de IPs, cada um na porta 1337, posicionados apenas por país. Use esta API para listar esses IPs e gerenciar a whitelist de IPs de origem.

Autenticação

Todos os endpoints autenticam com um parâmetro de query api_token. Gere um token no painel em Account → API Tokens.

?api_token=YOUR_API_TOKEN

O parâmetro de caminho {membership} aceita qualquer uma das duas formas: o ID numérico do plano (o número exibido na página do plano no painel) ou seu ID de API (o código curto no final da URL do plano no painel, por exemplo https://shifter.io/panel/membership/DeeJ). Ambos resolvem para o mesmo plano.

Listar proxies

GET https://shifter.io/api/v1/static-residential/{membership}/proxies

Retorna todos os IPs do seu plano legado, cada um como ip:port. A mesma porta (1337) e o mesmo usuário/senha se aplicam a todo o pool, portanto apenas o IP muda. As credenciais não fazem parte desta resposta; elas estão no painel.

Parâmetro	Em	Obrigatório	Descrição
`membership`	path	sim	O ID do plano (numérico ou ID de API)
`api_token`	query	sim	O token de API da sua conta

Exemplo:

curl "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/proxies?api_token=YOUR_API_TOKEN"

Resposta:

{
  "error": null,
  "code": 200,
  "data": [
    "185.199.108.153:1337",
    "185.199.108.154:1337",
    "185.199.108.155:1337"
  ]
}

Cada entrada é ip:port. A porta (1337) e o usuário/senha são os mesmos para todos os IPs do pool, apenas o IP muda; as credenciais estão na página do plano no painel, em My Plans. Em um plano legado, os países onde seus IPs estão localizados foram escolhidos uma vez no momento da compra e permanecem fixos depois disso.

IPs de origem autorizados

Adicione IPs de origem a uma whitelist para que seus scrapers possam pular a autenticação HTTP Basic em cada requisição. A whitelist se aplica a todo o plano legado: qualquer origem na whitelist pode usar qualquer IP dele. Os planos ISP Proxies atuais não suportam whitelist de IP; eles autenticam apenas com nome de usuário e senha.

Listar IPs autorizados

GET https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

Parâmetro	Em	Obrigatório	Descrição
`membership`	path	sim	O ID do plano
`api_token`	query	sim	O token de API da sua conta

Resposta:

{
  "error": null,
  "code": 200,
  "data": [
    "198.51.100.10",
    "203.0.113.42"
  ]
}

Atualizar IPs autorizados

PUT https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

Substitui a lista de IPs autorizados pelos valores fornecidos.

Parâmetro	Em	Obrigatório	Descrição
`membership`	path	sim	O ID do plano
`api_token`	query	sim	O token de API da sua conta
`ips[]`	body	sim	Array de endereços IPv4 para adicionar à whitelist

Exemplo (codificado como formulário, com sobrescrita de método):

curl -X POST "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/authorized-ips?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&ips[]=198.51.100.10&ips[]=203.0.113.42"

Veja também

Visão geral do ISP Proxies, para planos atuais
Gerenciando IPs, posicionando IPs por cidade e ISP em planos atuais

Começar

Proxies

APIs

Recursos