传统套餐管理API
本页介绍旧版按端口计费套餐的管理 API，即拥有固定端口范围（而非基于流量的网关）的保留客户。使用这些端点可将来源 IP 加入白名单、设置每个端口的地理位置默认值,以及获取已分配的端口列表。
所有端点均使用 api_token 查询参数进行身份验证。请在面板的账户 → API 令牌下生成令牌。
?api_token=YOUR_API_TOKEN{membership} 路径参数即为您的套餐 ID，可在面板的套餐页面中查看。
旧版套餐仅通过来源 IP 进行身份验证，请将您的抓取工具连接所用的 IP 加入白名单。
列出已授权的 IP
Section titled “列出已授权的 IP” GET https://shifter.io/api/v1/backconnect/{membership}/authorized-ips
| 参数 | 位置 | 是否必需 | 描述 |
|---|---|---|---|
membership | path | 是 | 套餐 ID |
api_token | query | 是 | 您的账户 API 令牌 |
示例：
curl "https://shifter.io/api/v1/backconnect/MEMBERSHIP_ID/authorized-ips?api_token=YOUR_API_TOKEN"响应：
{ "ips": ["198.51.100.10", "203.0.113.42"]}更新已授权的 IP
Section titled “更新已授权的 IP” PUT https://shifter.io/api/v1/backconnect/{membership}/authorized-ips
用提供的值替换已授权 IP 列表。
| 参数 | 位置 | 是否必需 | 描述 |
|---|---|---|---|
membership | path | 是 | 套餐 ID |
api_token | query | 是 | 您的账户 API 令牌 |
ips[] | body | 是 | 要加入白名单的 IPv4 地址数组 |
示例（表单编码，使用方法覆盖）：
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"地理位置默认值
Section titled “地理位置默认值”旧版端口具有按套餐设置的地理位置分配。设置一次后，套餐中的每个端口都会通过所配置国家（或高级筛选条件）内的 IP 进行路由。
获取当前地理位置分配
Section titled “获取当前地理位置分配” GET https://shifter.io/api/v1/backconnect/{membership}/geo
| 参数 | 位置 | 是否必需 | 描述 |
|---|---|---|---|
membership | path | 是 | 套餐 ID |
api_token | query | 是 | 您的账户 API 令牌 |
响应：
{ "geo": ["us", "gb"], "advanced_geo": []}更新地理位置分配
Section titled “更新地理位置分配” PUT https://shifter.io/api/v1/backconnect/{membership}/geo
| 参数 | 位置 | 是否必需 | 描述 |
|---|---|---|---|
membership | path | 是 | 套餐 ID |
api_token | query | 是 | 您的账户 API 令牌 |
geo[] | body | 是 | ISO-3166-1 alpha-2 国家代码数组 |
advanced_geo[] | body | 否 | 高级地理位置筛选条件数组（城市或 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" GET https://shifter.io/api/v1/backconnect/{membership}/proxies
返回旧版套餐中每个端口对应的 host:port 条目列表。
| 参数 | 位置 | 是否必需 | 描述 |
|---|---|---|---|
membership | path | 是 | 套餐 ID |
api_token | query | 是 | 您的账户 API 令牌 |
响应：
{ "proxies": [ { "host": "apollo.p.shifter.io", "port": 10001 }, { "host": "zeus.p.shifter.io", "port": 10002 }, { "host": "cronos.p.shifter.io", "port": 10003 } ]}许多支持代理的 HTTP 客户端会移除非标准方法。管理 API 接受带有 _method=PUT 表单字段的 POST 请求，效果等同于 PUT。