デフォルト Geo
Docsデフォルト Geo

デフォルト Geo(プールパラメータ)

デフォルトの Geo と動作プロファイルを永続化し、毎回クエリパラメータを渡さなくても /proxies が Geo ターゲット済みのクレデンシャルを返すようにします。

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 に戻ります。

永続化された Geo はプロバイダーが解決

永続化されたデフォルト Geo は接続時にアップストリームプロバイダーが強制します。/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 '{}'