REST API 参考
本节介绍代理管理 API，用于对住宅代理（Residential Proxies）、ISP 代理（ISP Proxies）和传统的基于端口的套餐进行地理位置查询、授权源 IP、地理位置默认设置以及代理列表的编程控制。
基础 URL
Section titled “基础 URL”| 产品 | 基础 URL |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| ISP Proxies | https://shifter.io/api/v1/static-residential |
| Legacy plans | https://shifter.io/api/v1/backconnect |
住宅代理（Residential Proxies）
Section titled “住宅代理（Residential Proxies）”将您的 api_key 作为查询参数传递。可在面板的Account → API Keys 中创建密钥。
curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"ISP 代理和传统套餐
Section titled “ISP 代理和传统套餐”使用您账户的 API 令牌作为 api_token 查询参数。可在面板的Account → API Tokens 中生成该令牌。
curl "https://shifter.io/api/v1/static-residential/YOUR_MEMBERSHIP_ID/proxies?api_token=YOUR_API_TOKEN"ISP 和传统端点中的 {membership} 路径参数是您的套餐 ID，可在面板的套餐页面上查看。
每个端点都会返回标准的 HTTP 状态码。失败时的响应体包含一个带有 error 和 message 的 JSON 对象。
{ "error": "invalid_api_key", "message": "The provided api_key is missing or invalid"}| 状态码 | 含义 |
|---|---|
200 | 成功 |
400 | 请求错误（参数格式错误或缺少必需参数） |
401 | 凭据无效或缺失 |
403 | 套餐不支持此功能或端点 |
404 | 未找到会员资格或资源 |
429 | 请求过多，请退避重试 |
500 | 内部错误，请退避重试 |
某些传统管理端点接受带有 _method=PUT 表单字段的 POST，其效果等同于 PUT，这在您的 HTTP 客户端会剥离非标准方法时非常有用。