Referência da API REST
Esta seção cobre as APIs de gerenciamento de proxy: controle programático sobre consultas de geolocalização, IPs de origem autorizados, padrões de geolocalização e a lista de proxies para Residential Proxies, planos legados de ISP com IP fixo e planos legados baseados em porta. Os planos atuais do ISP Proxies não possuem API de gerenciamento; suas linhas de proxy estão na página do plano no painel, veja ISP Proxies.
URLs base
Seção intitulada “URLs base”| Produto | URL base |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| Planos legados de ISP (IPs fixos) | https://shifter.io/api/v1/static-residential |
| Planos legados | https://shifter.io/api/v1/backconnect |
Autenticação
Seção intitulada “Autenticação”Residential Proxies
Seção intitulada “Residential Proxies”Passe seu api_key como parâmetro de consulta. Crie chaves no painel em Account → API Keys.
curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"Planos legados de ISP e planos legados baseados em porta
Seção intitulada “Planos legados de ISP e planos legados baseados em porta”Use o token de API da sua conta como o parâmetro de consulta api_token. Gere-o no painel em Account → API Tokens.
curl "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/proxies?api_token=YOUR_API_TOKEN"O parâmetro de caminho {membership} aceita tanto o Membership ID exibido na página do plano no painel (por exemplo, 68057) quanto o código curto da URL do plano (por exemplo, Rxqk).
Todo endpoint retorna um status HTTP padrão. Os corpos de resposta de falhas incluem um objeto JSON com error e message.
{ "error": "invalid_api_key", "message": "The provided api_key is missing or invalid"}| Status | Significado |
|---|---|
200 | Sucesso |
400 | Requisição inválida (parâmetro obrigatório malformado ou ausente) |
401 | Credenciais inválidas ou ausentes |
403 | O plano não permite este recurso ou endpoint |
404 | Membership ou recurso não encontrado |
429 | Muitas requisições, tente novamente com backoff |
500 | Erro interno, tente novamente com backoff |
Substituições de método
Seção intitulada “Substituições de método”Alguns endpoints de gerenciamento legados aceitam POST com um campo de formulário _method=PUT como equivalente a PUT, útil quando seu cliente HTTP remove métodos não padrão.