Bu kılavuz, coğrafi hedefli ve rotasyonlu bir residential listesi oluşturmayı gösterir.
Her istek, hesap panelinizdeki kişisel API anahtarınızı kullanır (API anahtarınızı nasıl alırsınız). Aşağıdaki örneklerde YOUR_API_KEY yerine kendi anahtarınızı yazın. Hesap bakiyenizden ödeme yapmak için paymentId = 1 kullanın.
Adım 1 — Paketi kontrol et
Residential paketinin aktif ve trafiği olduğunu doğrula. package_key değerini kopyala.
Uç nokta
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
Yanıt
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
Adım 2 — Mevcut konumları al
Tam GEO değerlerini bilmek için mevcut konumları (ülke / bölge / şehir / ISP) indir. Yanıt, tam GEO ağacını içeren bir JSON/ZIP'tir.
Uç nokta
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/geo
Yanıt
[
{
"code": "US",
"name": "United States",
"regions": [
{ "name": "Washington", "cities": [ { "name": "Garfield", "isps": [ "FIRST-STEP" ] } ] }
]
}
]
Adım 3 — Listeyi oluştur
Listeyi bir başlık, geo nesnesi (Adım 2'den), export ayarları ve rotasyon değeriyle oluştur.
Uç nokta
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
İstek gövdesi
Ad | Tür | Açıklama |
title | String | Listenin adı. |
whitelist (isteğe bağlı) | String | Yetkilendirme için IP'ler. Kullanıcı:şifre için boş bırak. |
geo | object | GEO veritabanından |
export | object | Nesne: |
rotation | Number | Rotasyon: |
Örnek
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Yanıt
{
"status": "success",
"data": {
"id": 561,
"title": "US Washington Garfield FIRST-STEP",
"login": "3c8aa1d4",
"password": "AZT62Dx3",
"geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
"export": { "ports": 10000, "ext": "txt" }
},
"errors": []
}
Adım 4 — Yeni listeyi kontrol et
Oluşturulduğunu doğrulamak ve bağlantı bilgilerini almak için residential listelerini listele.
Uç nokta
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
Yanıt
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}