Referência da REST API
Esta seção cobre as APIs de gerenciamento de proxy — controle programático sobre buscas geográficas, IPs de origem autorizados, padrões de geolocalização e a lista de proxies para Residential Proxies, ISP Proxies e planos legados baseados em porta.
URLs base
Seção intitulada “URLs base”| Produto | URL base |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| ISP Proxies | 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"ISP Proxies e planos legados
Seção intitulada “ISP Proxies e planos legados”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_MEMBERSHIP_ID/proxies?api_token=YOUR_API_TOKEN"O parâmetro de caminho {membership} nos endpoints de ISP e legados é o ID do seu plano, exibido no painel na página do plano.
Todo endpoint retorna um status HTTP padrão. Corpos de resposta para 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 | Excesso de 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.