Bu kılavuz, sıfırdan API ile yeni proxy satın almayı gösterir — neyin mevcut olduğunu kontrol et, fiyatı hesapla, siparişi ver ve satın alınan IP'leri al.

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.

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

Akışa genel bakış

Bakiyeni kontrol et.
Neyin sipariş edilebileceğine bak (ülke, süre).
Bir ödeme yöntemi seç (veya bakiyeni kullan).
Fiyatı hesapla.
Siparişi ver.
Satın alınan proxy'leri al.

Adım 1 — Bakiyeni kontrol et

Satın alma için yeterli bakiyen olduğundan emin ol.

Uç nokta

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

Yanıt

{
  "status": "success",
  "data": { "summ": 10 },
  "errors": []
}

Adım 2 — Neyin sipariş edilebileceğine bak

Reference List, sipariş için gereken her şeyi döndürür: ülkeler, süreler, hedefler, operatörler ve rotasyonlar (mobil için). Gereken countryId ve periodId değerlerini kopyala.

Uç nokta

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

Yol parametreleri

Ad	Değer	Açıklama
type	`ipv4`	Proxy türü (ipv4, ipv6, mobile, isp, mix, mix_isp).

Örnek

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

Yanıt

{
  "status": "success",
  "data": {
    "items": [
      {
        "country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
        "period":  [ { "id": "1m", "name": "1 month" } ]
      }
    ]
  },
  "errors": []
}

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

Mevcut ödeme sistemlerini listele ve istediğin id değerini paymentId olarak kopyala. Bakiyeden ödemek için doğrudan paymentId = 1 kullan.

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 4 — Fiyatı hesapla

Satın almadan önce sipariş fiyatını hesapla. Hacim ve kiralama süresi indirimleri web sitesindeki gibi uygulanır. Bu adım ücret kesmez.

Gövde alanları proxy türüne bağlıdır. Ortak alanlar aşağıda; IPv6 için ayrıca protocol, mobil için operatorId + rotationId, residential için tarifId — hepsi Reference List'ten.

Uç nokta

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

İstek gövdesi

Ad	Tür	Açıklama
countryId	Number	Reference List'teki ülkenin ID'si (Adım 2).
periodId	String	Reference List'teki kiralama süresinin ID'si.
quantity	Number	Sipariş edilecek proxy sayısı.
paymentId	Number	Ödeme sistemi ID'si. `1` = bakiye, `43` = eklenen kart.
coupon (isteğe bağlı)	String	Varsa bir kupon kodu.
authorization (isteğe bağlı)	String	Yetkilendirme yöntemi. Kullanıcı adı:şifre için boş bırak.
customTargetName (isteğe bağlı)	String	Gerekirse özel bir hedef adı.

Örnek

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

Yanıt — shows the total, your balance, the discount and the per-proxy price:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 2000,
    "total": 9,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.45,
    "price": 1.8
  },
  "errors": []
}

Adım 5 — Siparişi ver (bakiyenden ücret keser)

Hesaplanan fiyat uygunsa siparişi ver. Bu adım bakiyenden ücret keser. Adım 4'teki parametrelerin aynısını kullan. Yanıttan orderId değerini kopyala.

Uç nokta

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

İstek gövdesi

Ad	Tür	Açıklama
countryId	Number	Reference List'teki ülkenin ID'si (Adım 2).
periodId	String	Reference List'teki kiralama süresinin ID'si.
quantity	Number	Sipariş edilecek proxy sayısı.
paymentId	Number	Ödeme sistemi ID'si. `1` = bakiye, `43` = eklenen kart.
coupon (isteğe bağlı)	String	Varsa bir kupon kodu.
authorization (isteğe bağlı)	String	Yetkilendirme yöntemi. Kullanıcı adı:şifre için boş bırak.
generateAuth (isteğe bağlı)	String	Y/N — özel yetkilendirme oluştur (varsayılan N).

Örnek

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

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

{
  "status": "success",
  "data": {
    "orderId": 2426273,
    "total": 16.2,
    "listBaseOrderNumbers": [ "3388485_57471911" ],
    "balance": 1776.88
  },
  "errors": []
}

Adım 6 — Satın alınan proxy'leri al

Satın alınan proxy'leri al. Tam olarak ne satın alındığını görmek için önceki adımdaki orderId ile filtrele.

Uç nokta

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

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",
        "date_start": "23.06.2024",
        "date_end": "23.07.2024"
      }
    ]
  },
  "errors": []
}