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.

Authentication

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.

Authorized IPs

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

List authorized IPs

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/MEMBERSHIP_ID/authorized-ips?api_token=YOUR_API_TOKEN"

Resposta:

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

Update authorized IPs

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/MEMBERSHIP_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"

Geo defaults

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).

Get current geo assignment

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": []
}

Update geo assignment

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/MEMBERSHIP_ID/geo?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&geo[]=us&geo[]=uk&geo[]=ca"

List 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 }
  ]
}

Method overrides

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.

See also

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