यह गाइड दिखाती है कि API के माध्यम से अपने मौजूदा प्रॉक्सी को कैसे नवीनीकृत (एक्सटेंड) करें ताकि वही IP पते बने रहें। समय पर नवीनीकरण करें — प्रॉक्सी समाप्त होने पर IP खो सकता है।

हर अनुरोध आपके अकाउंट डैशबोर्ड से आपकी व्यक्तिगत API कुंजी का उपयोग करता है (API कुंजी कैसे प्राप्त करें)। नीचे दिए उदाहरणों में YOUR_API_KEY को अपनी कुंजी से बदलें। अकाउंट बैलेंस से भुगतान के लिए paymentId = 1 का उपयोग करें।

⚠️ अंतिम चरण आपके बैलेंस से शुल्क लेता है। हमेशा पहले गणना चरण में लागत जाँचें।

प्रक्रिया एक नज़र में

नवीनीकरण के लिए प्रॉक्सी ढूँढें और उनके ID कॉपी करें।
भुगतान विधि चुनें (या अपना बैलेंस उपयोग करें)।
नवीनीकरण की लागत की गणना करें।
नवीनीकरण करें।

चरण 1 — नवीनीकरण के लिए प्रॉक्सी ढूँढें

अपने सक्रिय प्रॉक्सी सूचीबद्ध करें और जिन्हें एक्सटेंड करना है उनका id कॉपी करें। केवल can_prolong: true वाले प्रॉक्सी नवीनीकृत किए जा सकते हैं। प्रॉक्सी प्रकार (ipv4, ipv6, mobile, isp, mix, mix_isp) नोट करें — अगले चरणों में इसकी ज़रूरत होगी।

एंडपॉइंट

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

पाथ पैरामीटर

नाम	मान	विवरण
type (वैकल्पिक)	`ipv4`	प्राप्त करने के लिए प्रॉक्सी प्रकार। यदि छोड़ा गया, तो सभी प्रकार लौटाए जाते हैं।

वैकल्पिक क्वेरी पैरामीटर

नाम	प्रकार	विवरण
latest	String	Y/N — केवल अंतिम ऑर्डर के प्रॉक्सी लौटाएँ।
orderId	String	किसी विशिष्ट orderId या baseOrderNumber के प्रॉक्सी लौटाएँ।
country	String	अल्फा-3 देश कोड (जैसे FRA, USA)।
ends	String	Y — केवल वे प्रॉक्सी जिनकी समय-सीमा समाप्त होने वाली है।

उदाहरण

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

रिस्पॉन्स

{
  "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": []
}

नवीनीकरण के लिए हर प्रॉक्सी का id कॉपी करें। सुनिश्चित करें कि can_prolong true है।

चरण 2 — भुगतान विधि चुनें

उपलब्ध भुगतान प्रणालियाँ सूचीबद्ध करें और जिसे चाहें उसका id paymentId के रूप में कॉपी करें। अकाउंट बैलेंस से भुगतान के लिए आप यह चरण छोड़कर बस paymentId = 1 उपयोग कर सकते हैं।

एंडपॉइंट

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

रिस्पॉन्स

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

चरण 3 — नवीनीकरण लागत की गणना करें

भुगतान से पहले लागत की गणना करें। मात्रा और किराये की अवधि पर छूट वेबसाइट की तरह ही लागू होती है। यह चरण कोई शुल्क नहीं लेता।

एंडपॉइंट

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

रिक्वेस्ट बॉडी

नाम	प्रकार	विवरण
ids	Number / Array	एक ID या `[ ]` में अल्पविराम से अलग किए IDs का array — चरण 1 से।
periodId	String	नवीनीकरण अवधि का ID। उपलब्ध अवधियाँ `/reference/list/{type}` एंडपॉइंट से प्राप्त करें।
paymentId	String	भुगतान प्रणाली ID। `1` = बैलेंस, `43` = आपके अकाउंट में जोड़ा गया कार्ड।
coupon (वैकल्पिक)	String	कूपन कोड, यदि आपके पास हो।

उदाहरण

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

रिस्पॉन्स — 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": []
}

यदि आपका बैलेंस बहुत कम है, तो आपको Insufficient funds चेतावनी मिलेगी:

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

चरण 4 — नवीनीकरण करें (बैलेंस से शुल्क लेता है)

जब गणना की गई लागत सही लगे, नवीनीकरण ऑर्डर बनाएँ। यह चरण आपके बैलेंस से शुल्क लेता है। चरण 3 के समान पैरामीटर उपयोग करें।

एंडपॉइंट

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

रिक्वेस्ट बॉडी

नाम	प्रकार	विवरण
ids	Number / Array	एक ID या `[ ]` में अल्पविराम से अलग किए IDs का array।
periodId	String	नवीनीकरण अवधि का ID (`/reference/list/{type}` से)।
paymentId	String	भुगतान प्रणाली ID। `1` = बैलेंस।
coupon (वैकल्पिक)	String	कूपन कोड, यदि आपके पास हो।

उदाहरण

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

रिस्पॉन्स — returns the new order ID and your updated balance:

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

प्रॉक्सी नई समाप्ति तिथि के साथ वही IP बनाए रखते हैं।