默认地理(池参数)
持久化默认地理与行为配置,使 /proxies 不必每次传查询参数就能返回地理定向凭据。
GET /packages/{id}/default-geo
返回当前持久化的默认池参数 — 国家、州、城市、ZIP、ASN、排除列表、匿名过滤、轮换间隔。
GET
/api/v1/packages/{id}/default-georesponse.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-georequest.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 '{}'