API de Gerenciamento de Planos Legados

Esta página aborda a API de gerenciamento para planos legados baseados em portas (clientes com direitos adquiridos, com um intervalo fixo de portas em vez do gateway baseado em tráfego). Use esses endpoints para colocar IPs de origem na lista de permissões, definir os padrões de geolocalização por porta e obter a lista de portas atribuídas.

Nota

Se o seu plano estiver no novo modelo baseado em tráfego Proxies Residenciais (gateway único p.shifter.io:443), use a API de Proxies Residenciais em vez disso. O direcionamento no novo modelo é codificado no nome de usuário a cada requisição, e não armazenado como padrão do plano.

Autenticação

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

?api_token=YOUR_API_TOKEN

O parâmetro de caminho {membership} é o ID do seu plano, exibido no painel na página do plano.

IPs autorizados

Planos legados autenticam apenas pelo IP de origem: coloque na lista de permissões os IPs a partir dos quais seus scrapers se conectam.

Listar IPs autorizados

GET https://shifter.io/api/v1/backconnect/{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

Exemplo:

curl "https://shifter.io/api/v1/backconnect/YOUR_PLAN_ID/authorized-ips?api_token=YOUR_API_TOKEN"

Resposta:

{
  "ips": ["198.51.100.10", "203.0.113.42"]
}

Atualizar IPs autorizados

PUT https://shifter.io/api/v1/backconnect/{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 colocar na lista de permissões

Exemplo (codificado como formulário, com substituição de método):

curl -X POST "https://shifter.io/api/v1/backconnect/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"

Padrões de geo

Portas legadas têm uma atribuição de geolocalização por plano. Defina-a uma vez e todas as portas do plano roteiam o tráfego através de IPs nos países configurados (ou filtros avançados).

Obter atribuição de geo atual

GET https://shifter.io/api/v1/backconnect/{membership}/geo

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:

{
  "geo": ["us", "gb"],
  "advanced_geo": []
}

Atualizar atribuição de geo

PUT https://shifter.io/api/v1/backconnect/{membership}/geo

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
geo[]	body	sim	Array de códigos de país ISO-3166-1 alpha-2
advanced_geo[]	body	não	Array de filtros avançados de geolocalização (cidade ou ASN)

curl -X POST "https://shifter.io/api/v1/backconnect/YOUR_PLAN_ID/geo?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&geo[]=us&geo[]=uk&geo[]=ca"

Listar proxies

GET https://shifter.io/api/v1/backconnect/{membership}/proxies

Retorna a lista de entradas host:port para cada porta do seu plano legado.

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:

{
  "proxies": [
    { "host": "apollo.p.shifter.io", "port": 10001 },
    { "host": "zeus.p.shifter.io", "port": 10002 },
    { "host": "cronos.p.shifter.io", "port": 10003 }
  ]
}

Substituições de método

Muitos clientes HTTP com suporte a proxy removem métodos não padrão. A API de gerenciamento aceita POST com um campo de formulário _method=PUT como equivalente a PUT.

Veja também

• Modelo de portas legado
• Autenticação: como a autenticação legada difere de Proxies Residenciais e Proxies ISP