允许的 IP
文档允许的 IP

允许的 IP(白名单)

通过管理客户端 IP 白名单,限制谁能对代理套餐进行身份验证。

GET /packages/{id}/allowed-ips

返回当前白名单。为空时,任何知道 login + password 的 IP 都能连接。

GET/api/v1/packages/{id}/allowed-ips
response.json
{
  "data": { "ips": ["203.0.113.7", "198.51.100.42"], "max": 5 },
  "meta": { "version": "v1" }
}

POST /packages/{id}/allowed-ips

将 IP(IPv4 或 IPv6)添加到白名单。每个套餐最多 5 个 IP。已存在返回 409,达上限返回 422。

POST/api/v1/packages/{id}/allowed-ips
request.json
{ "ip": "203.0.113.7" }
response.json
{
  "data": { "ips": ["203.0.113.7", "198.51.100.42"] },
  "meta": { "version": "v1" }
}

DELETE /packages/{id}/allowed-ips/{ip}

从白名单移除 IP。成功 204,不存在 404。

DELETE/api/v1/packages/{id}/allowed-ips/{ip}

注意

非空白名单会禁用密码认证:只有白名单 IP 上的客户端可连接,与凭据无关。清空白名单可恢复密码认证。

代码示例

allowed-ips.sh
# List
curl https://raxyproxy.com/api/v1/packages/12/allowed-ips \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Add
curl -X POST https://raxyproxy.com/api/v1/packages/12/allowed-ips \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{"ip":"203.0.113.7"}'

# Remove
curl -X DELETE https://raxyproxy.com/api/v1/packages/12/allowed-ips/203.0.113.7 \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
allowed-ips.py
import requests

API_KEY    = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
PACKAGE_ID = 12
HEADERS    = {'Authorization': f'Bearer {API_KEY}'}
BASE       = f'https://raxyproxy.com/api/v1/packages/{PACKAGE_ID}/allowed-ips'

# Snapshot my current public IP into the whitelist
my_ip = requests.get('https://api.ipify.org').text
r = requests.post(BASE, headers=HEADERS, json={'ip': my_ip})
print(r.status_code, r.json())