默认地理
文档默认地理

默认地理(池参数)

持久化默认地理与行为配置,使 /proxies 不必每次传查询参数就能返回地理定向凭据。

GET /packages/{id}/default-geo

返回当前持久化的默认池参数 — 国家、州、城市、ZIP、ASN、排除列表、匿名过滤、轮换间隔。

GET/api/v1/packages/{id}/default-geo
response.json
{
  "data": {
    "countries":         ["us", "gb"],
    "states":            [],
    "cities":            [],
    "zipcodes":          [],
    "asns":              [],
    "exclude_countries": ["cn", "ru"],
    "exclude_asn":       [],
    "anonymous_filter":  true,
    "rotation_interval": 30
  },
  "meta": { "version": "v1" }
}

PUT /packages/{id}/default-geo

持久化新默认值。PUT 语义:请求体完全替换之前的配置 — 省略字段恢复为空/false/null。

持久化地理由提供商解析

持久化的默认地理由上游提供商在连接时强制执行。/packages/{id}/proxies 上的逐请求查询参数仍可覆盖默认值。州/城市/ZIP/ASN 的 2× 流量加价同样适用。

PUT/api/v1/packages/{id}/default-geo
request.json
{
  "countries":         ["us"],
  "states":            ["california"],
  "exclude_countries": [],
  "anonymous_filter":  true,
  "rotation_interval": 60
}

代码示例

default-geo.sh
# Inspect current default
curl https://raxyproxy.com/api/v1/packages/12/default-geo \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Replace: pin to US, exclude CN/RU, anonymous-only, 60-min rotation
curl -X PUT https://raxyproxy.com/api/v1/packages/12/default-geo \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{"countries":["us"],"exclude_countries":["cn","ru"],"anonymous_filter":true,"rotation_interval":60}'

# Clear (revert to rotating worldwide)
curl -X PUT https://raxyproxy.com/api/v1/packages/12/default-geo \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{}'