Bu kılavuz, aynı IP adreslerini korumak için sahip olduğun proxy'leri API ile nasıl yenileyeceğini (uzatacağını) gösterir. Zamanında yenile — proxy'nin süresi dolduğunda IP kaybolabilir.

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.

⚠️ Son adım bakiyenizden ücret keser. Önce her zaman hesaplama adımında maliyeti kontrol edin.

Akışa genel bakış

Yenilenecek proxy'leri bul ve ID'lerini kopyala.
Bir ödeme yöntemi seç (veya bakiyeni kullan).
Yenileme maliyetini hesapla.
Yenilemeyi yap.

Adım 1 — Yenilenecek proxy'leri bul

Aktif proxy'lerini listele ve uzatmak istediğin her birinin id değerini kopyala. Yalnızca can_prolong: true olan proxy'ler yenilenebilir. Proxy türünü (ipv4, ipv6, mobile, isp, mix, mix_isp) not et — sonraki adımlarda gerekecek.

Uç nokta

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Yol parametreleri

Ad	Değer	Açıklama
type (isteğe bağlı)	`ipv4`	Alınacak proxy türü. Belirtilmezse tüm türler döner.

İsteğe bağlı sorgu parametreleri

Ad	Tür	Açıklama
latest	String	Y/N — yalnızca son siparişteki proxy'leri döndürür.
orderId	String	Belirli bir orderId veya baseOrderNumber'daki proxy'leri döndürür.
country	String	Alpha-3 ülke kodu (örn. FRA, USA).
ends	String	Y — yalnızca süresi dolmak üzere olan proxy'ler.

Örnek

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/ipv4

Yanıt

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "0678564",
        "order_id": "123456",
        "ip": "31.6.33.97",
        "protocol": "HTTP",
        "port_http": 12345,
        "port_socks": 12345,
        "login": "ruht5734hg",
        "password": "gou5h437g",
        "country": "Belgium",
        "country_alpha3": "BEL",
        "status_type": "ACTIVE",
        "can_prolong": true,
        "date_start": "23.06.2024",
        "date_end": "23.07.2024",
        "auto_renew": "N"
      }
    ]
  },
  "errors": []
}

Yenilenecek her proxy'nin id değerini kopyala. can_prolong değerinin true olduğundan emin ol.

Adım 2 — Bir ödeme yöntemi seç

Mevcut ödeme sistemlerini listele ve istediğin id değerini paymentId olarak kopyala. Hesap bakiyenden ödemek için bu adımı atlayıp doğrudan paymentId = 1 kullanabilirsin.

Uç nokta

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list

Yanıt

{
  "status": "success",
  "data": {
    "items": [
      { "id": "30", "name": "Visa / MasterCard" },
      { "id": "41", "name": "USDT (TRC-20)" },
      { "id": "29", "name": "PayPal" },
      { "id": "35", "name": "Binance" }
    ]
  },
  "errors": []
}

Adım 3 — Yenileme maliyetini hesapla

Ödemeden önce maliyeti hesapla. Hacim ve kiralama süresi indirimleri web sitesindeki gibi uygulanır. Bu adım hiçbir ücret kesmez.

Uç nokta

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/{type}

İstek gövdesi

Ad	Tür	Açıklama
ids	Number / Array	Tek bir ID veya `[ ]` içinde virgülle ayrılmış ID dizisi — Adım 1'den.
periodId	String	Yenileme süresinin ID'si. Mevcut süreleri `/reference/list/{type}` uç noktasından alabilirsin.
paymentId	String	Ödeme sistemi ID'si. `1` = bakiye, `43` = hesabına eklenen kart.
coupon (isteğe bağlı)	String	Varsa bir kupon kodu.

Örnek

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/ipv4

Yanıt — shows the total, your balance, the discount and the proxies being renewed:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 40.4,
    "total": 35.1,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.22,
    "items": [ ... proxies being renewed ... ],
    "orders": 2
  },
  "errors": []
}

Bakiyen çok düşükse Insufficient funds uyarısı alırsın:

{
  "status": "error",
  "data": {
    "warning": "Insufficient funds. Total $2. Not enough $33.10",
    "balance": 2,
    "total": 35.1
  },
  "errors": []
}

Adım 4 — Yenilemeyi yap (bakiyenden ücret keser)

Hesaplanan maliyet uygunsa yenileme siparişini oluştur. Bu adım bakiyenden ücret keser. Adım 3'teki parametrelerin aynısını kullan.

Uç nokta

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/{type}

İstek gövdesi

Ad	Tür	Açıklama
ids	Number / Array	Tek bir ID veya `[ ]` içinde virgülle ayrılmış ID dizisi.
periodId	String	Yenileme süresinin ID'si (`/reference/list/{type}`'ten).
paymentId	String	Ödeme sistemi ID'si. `1` = bakiye.
coupon (isteğe bağlı)	String	Varsa bir kupon kodu.

Örnek

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/ipv4

Yanıt — returns the new order ID and your updated balance:

{
  "status": "success",
  "data": {
    "orderId": 3388536,
    "total": 35.1,
    "listBaseOrderNumbers": [ "1000000_57471911" ],
    "balance": 40.4
  },
  "errors": []
}

Proxy'ler aynı IP'leri yeni bir bitiş tarihiyle korur.