Géo par défaut
DocsGéo par défaut

Géo par défaut (paramètres du pool)

Persistez un géo et profil de comportement par défaut, pour que /proxies renvoie des credentials géo-ciblés sans passer de query params à chaque fois.

GET /packages/{id}/default-geo

Retourne les paramètres du pool persistés — pays, états, villes, ZIP, ASNs, exclusions, filtre d'anonymat, intervalle de rotation.

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

Persiste un nouveau défaut. Sémantique PUT : le body remplace entièrement la config précédente — champs omis réinitialisés à vide/false/null.

Le géo persistant est résolu par le fournisseur

Le géo par défaut persisté est appliqué par le fournisseur upstream à la connexion. Les query params per-request sur /packages/{id}/proxies écrasent toujours le défaut. La surcharge 2× pour état/ville/ZIP/ASN s'applique pareil.

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

Exemples de code

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 '{}'