الجغرافيا الافتراضية
Docsالجغرافيا الافتراضية

الجغرافيا الافتراضية (معاملات المجموعة)

احفظ ملف جغرافيا وسلوك افتراضي ليُعيد /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.

الجغرافيا المحفوظة يحلّها المزوّد

يُفرض الـ Geo الافتراضي المحفوظ من المزوّد الخلفي عند الاتصال. معاملات الاستعلام لكل طلب على /packages/{id}/proxies ما زالت تتجاوز الافتراضي. تنطبق رسوم 2× الإضافية للولاية/المدينة/ZIP/ASN بالأسلوب نفسه.

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