यह गाइड दिखाती है कि API के माध्यम से शुरुआत से नए प्रॉक्सी कैसे खरीदें — उपलब्धता जाँचें, कीमत की गणना करें, ऑर्डर दें और खरीदे गए IP प्राप्त करें।

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

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

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

अपना बैलेंस जाँचें।
देखें क्या ऑर्डर किया जा सकता है (देश, अवधि)।
भुगतान विधि चुनें (या अपना बैलेंस उपयोग करें)।
कीमत की गणना करें।
ऑर्डर दें।
खरीदे गए प्रॉक्सी प्राप्त करें।

चरण 1 — अपना बैलेंस जाँचें

सुनिश्चित करें कि खरीद के लिए पर्याप्त बैलेंस है।

एंडपॉइंट

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

रिस्पॉन्स

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

चरण 2 — देखें क्या ऑर्डर किया जा सकता है

Reference List ऑर्डर देने के लिए आवश्यक सब कुछ लौटाता है: देश, अवधि, लक्ष्य, कैरियर और रोटेशन (मोबाइल के लिए)। आवश्यक countryId और periodId कॉपी करें।

एंडपॉइंट

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

पाथ पैरामीटर

नाम	मान	विवरण
type	`ipv4`	प्रॉक्सी प्रकार (ipv4, ipv6, mobile, isp, mix, mix_isp)।

उदाहरण

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

रिस्पॉन्स

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

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

उपलब्ध भुगतान प्रणालियाँ सूचीबद्ध करें और जिसे चाहें उसका 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": []
}

चरण 4 — कीमत की गणना करें

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

बॉडी फ़ील्ड प्रॉक्सी प्रकार पर निर्भर करते हैं। सामान्य फ़ील्ड नीचे हैं; IPv6 के लिए protocol भी भेजें, mobile के लिए operatorId + rotationId, residential के लिए tarifId — सभी Reference List से।

एंडपॉइंट

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

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

नाम	प्रकार	विवरण
countryId	Number	Reference List से देश का ID (चरण 2)।
periodId	String	Reference List से किराये की अवधि का ID।
quantity	Number	ऑर्डर करने के लिए प्रॉक्सी की संख्या।
paymentId	Number	भुगतान प्रणाली ID। `1` = बैलेंस, `43` = जोड़ा गया कार्ड।
coupon (वैकल्पिक)	String	कूपन कोड, यदि आपके पास हो।
authorization (वैकल्पिक)	String	प्राधिकरण विधि। लॉगिन:पासवर्ड उपयोग के लिए खाली छोड़ें।
customTargetName (वैकल्पिक)	String	आवश्यकता हो तो कस्टम लक्ष्य/टारगेट नाम।

उदाहरण

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

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

चरण 5 — ऑर्डर दें (बैलेंस से शुल्क लेता है)

जब गणना की गई कीमत सही लगे, ऑर्डर दें। यह चरण आपके बैलेंस से शुल्क लेता है। चरण 4 के समान पैरामीटर उपयोग करें। रिस्पॉन्स से orderId कॉपी करें।

एंडपॉइंट

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

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

नाम	प्रकार	विवरण
countryId	Number	Reference List से देश का ID (चरण 2)।
periodId	String	Reference List से किराये की अवधि का ID।
quantity	Number	ऑर्डर करने के लिए प्रॉक्सी की संख्या।
paymentId	Number	भुगतान प्रणाली ID। `1` = बैलेंस, `43` = जोड़ा गया कार्ड।
coupon (वैकल्पिक)	String	कूपन कोड, यदि आपके पास हो।
authorization (वैकल्पिक)	String	प्राधिकरण विधि। लॉगिन:पासवर्ड उपयोग के लिए खाली छोड़ें।
generateAuth (वैकल्पिक)	String	Y/N — कस्टम प्राधिकरण बनाएँ (डिफ़ॉल्ट N)।

उदाहरण

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

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

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

चरण 6 — खरीदे गए प्रॉक्सी प्राप्त करें

खरीदे गए प्रॉक्सी प्राप्त करें। ठीक वही देखने के लिए जो खरीदा गया, पिछले चरण के orderId से फ़िल्टर करें।

एंडपॉइंट

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

रिस्पॉन्स

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