ProxyWing
एंडपॉइंट ब्राउज़ करें
EN

ProxyWing डेवलपर API

डेटासेंटर

डेटासेंटर प्रॉक्सी ऑर्डर करें, उनकी लिस्ट देखें, अवधि बढ़ाएं, क्रेडेंशियल रोटेट करें और IP व्हाइटलिस्ट करें।

GET /datacenter/products

डेटासेंटर प्रोडक्ट की लिस्ट

खरीद के लिए उपलब्ध डेटासेंटर प्रॉक्सी प्रोडक्ट, हर लोकेशन की कीमत के साथ लौटाता है।

ऑथेंटिकेशन · Bearer
रिक्वेस्ट GET /datacenter/products
curl -X GET "https://api.proxywing.com/v1/datacenter/products" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
रिस्पॉन्स 200 · application/json
{
  "products": [
    {
      "product_id": "dcprod_3",
      "location": "UK",
      "quantity": 1,
      "price_monthly": 1.8
    }
  ]
}
POST /datacenter/orders

डेटासेंटर प्रॉक्सी ऑर्डर करें

अकाउंट बैलेंस से डेटासेंटर प्रॉक्सी प्रोडक्ट खरीदता है और उसे तुरंत प्रोविज़न करता है। billing_cycle के लिए monthly, quarterly, semiannually या annually चुनें — लंबी अवधि का बिल प्रोडक्ट की प्रति-अवधि छूट वाली कीमत पर बनता है (वेब चेकआउट वाली दरें ही), और total फ़ील्ड ठीक वही रकम बताता है जो चार्ज हुई। Idempotency-Key हेडर भेजें, ताकि टाइमआउट हुई रिक्वेस्ट दोबारा भेजने पर अकाउंट से दो बार पैसे न कटें। रिस्पॉन्स में मिला order_id वही ID है जिसे आप इस संसाधन की हर अगली कॉल में इस्तेमाल करते हैं, और यह ऑर्डर प्रोविज़न होने के बाद ही पता चलता है — जब तक ऑर्डर awaiting_payment में है, यह null रहता है। इनवॉइस चुकाएं, फिर संसाधन पाने के लिए या तो बैलेंस से चुकाए गए ऑर्डर का रिस्पॉन्स दोबारा पढ़ें या संबंधित लिस्ट एंडपॉइंट को बार-बार जांचें। इस एंडपॉइंट पर Idempotency-Key ज़रूरी है — इसके बिना 400 लौटता है और कुछ भी चार्ज नहीं होता।

ऑथेंटिकेशन · Bearer Idempotency-Key

बॉडी पैरामीटर

  • product_id string ज़रूरी

    ऑर्डर किया जाने वाला प्रोडक्ट, GET /datacenter/products से।

  • billing_cycle string वैकल्पिक

    बिलिंग अवधि: "monthly" (डिफ़ॉल्ट), "quarterly", "semiannually" या "annually"। लंबी अवधि का बिल प्रोडक्ट की प्रति-अवधि छूट वाली कीमत पर बनता है। (इनकी जगह महीनों की संख्या 1/3/6/12 भी स्वीकार की जाती है।)

  • promo_code string वैकल्पिक

    वैकल्पिक प्रोमो कोड। API के ज़रिए सिर्फ़ 100% से कम प्रतिशत छूट वाले प्रोमो कोड लागू होते हैं (जो कोड कुल रकम को शून्य कर दे, वह अस्वीकार हो जाता है)।

रिक्वेस्ट POST /datacenter/orders
curl -X POST "https://api.proxywing.com/v1/datacenter/orders" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Idempotency-Key: b3f2a1c4-7e9d-4a2b-8c6f-1d5e9a0b3c7f" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"dcprod_3","billing_cycle":"annually"}'
रिस्पॉन्स 200 · application/json
{
  "order_id": "ord_3JO0ArTC2d2keb5YTlom",
  "invoice_id": "inv_200001",
  "product_id": "dcprod_3",
  "billing_cycle": "annually",
  "total": 19.44,
  "status": "paid"
}
GET /datacenter/orders/{ord_id}/renewal-options

रिन्यूअल विकल्प पाएं

किसी ऑर्डर के लिए अवधि बढ़ाने के उपलब्ध विकल्प लौटाता है — 1, 3, 6 और 12 महीने — हर एक की कीमत के साथ। लंबी अवधि पर प्रोडक्ट की प्रति-अवधि छूट वाली कीमत लगती है, इसलिए 3/6/12 महीने की कीमत मासिक कीमत गुणा महीनों की संख्या से कम होती है। इनमें से कोई एक months वैल्यू अवधि बढ़ाने वाले एंडपॉइंट को cycle के रूप में भेजें। यहां सिर्फ़ मासिक सेवाओं की कीमत निकाली जा सकती है; गैर-मासिक सेवा पर फ़िलहाल साफ़ 4xx की जगह 500 मिलता है।

ऑथेंटिकेशन · Bearer

पथ पैरामीटर

  • ord_id string ज़रूरी

    ऑर्डर ID, जैसे ord_100001, GET /datacenter/proxies से।

रिक्वेस्ट GET /datacenter/orders/{ord_id}/renewal-options
curl -X GET "https://api.proxywing.com/v1/datacenter/orders/{ord_id}/renewal-options" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
रिस्पॉन्स 200 · application/json
{
  "order_id": "ord_100001",
  "next_due_date": "2026-09-02",
  "options": [
    {
      "months": 1,
      "total": 1.8,
      "label": "1 Month",
      "discount_pct": 0
    },
    {
      "months": 3,
      "total": 5.15,
      "label": "3 Months",
      "discount_pct": 5
    },
    {
      "months": 6,
      "total": 10.05,
      "label": "6 Months",
      "discount_pct": 7
    },
    {
      "months": 12,
      "total": 19.44,
      "label": "12 Months",
      "discount_pct": 10
    }
  ]
}
POST /datacenter/orders/{ord_id}/extend

डेटासेंटर ऑर्डर की अवधि बढ़ाएं

ऑर्डर की मूल सेवा के लिए रिन्यूअल इनवॉइस बनाता है और उसे अकाउंट बैलेंस से चुकाता है। भुगतान होने पर सेवा की अगली देय तारीख और प्रॉक्सी की समाप्ति तारीख cycle महीने आगे बढ़ जाती है — status "paid" होता है और next_due_date नई देय तारीख की पुष्टि करता है। लंबी अवधि का बिल प्रोडक्ट की प्रति-अवधि छूट वाली कीमत पर बनता है (देखें GET /datacenter/orders/{ord_id}/renewal-options)। अगर बैलेंस total के लिए काफ़ी नहीं है, तो इनवॉइस खुला रहता है और status "awaiting_payment" होता है; बैलेंस टॉप-अप करें और वही इनवॉइस चुकाने के लिए कॉल दोहराएं (दूसरा इनवॉइस कभी नहीं जुड़ता)। Idempotency-Key हेडर भेजें, ताकि दोबारा कोशिश करने पर अवधि दो बार न बढ़े। Idempotency-Key ज़रूरी है — इसके बिना कुछ भी चार्ज होने से पहले ही 400 लौटता है। API के ज़रिए सिर्फ़ मासिक बिलिंग अवधि वाली सेवाओं की अवधि बढ़ाई जा सकती है, और सेवा सक्रिय या निलंबित होनी चाहिए; बाकी सब अस्वीकार कर दिया जाता है। तिमाही, छमाही या सालाना अवधि पर ऑर्डर की गई सेवा की अवधि यहां नहीं बढ़ाई जा सकती।

ऑथेंटिकेशन · Bearer Idempotency-Key

पथ पैरामीटर

  • ord_id string ज़रूरी

    जिस ऑर्डर की अवधि बढ़ानी है उसकी ID, जैसे ord_100001।

बॉडी पैरामीटर

  • cycle integer ज़रूरी

    अवधि कितने महीने बढ़ानी है: 1, 3, 6 या 12। हर विकल्प की कीमत के लिए GET /renewal-options देखें।

  • cycle_type string ज़रूरी

    "monthly" ही होना चाहिए — अवधि की यही एकमात्र समर्थित यूनिट है।

रिक्वेस्ट POST /datacenter/orders/{ord_id}/extend
curl -X POST "https://api.proxywing.com/v1/datacenter/orders/{ord_id}/extend" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Idempotency-Key: b3f2a1c4-7e9d-4a2b-8c6f-1d5e9a0b3c7f" \
  -H "Content-Type: application/json" \
  -d '{"cycle":3,"cycle_type":"monthly"}'
रिस्पॉन्स 200 · application/json
{
  "order_id": "ord_100001",
  "invoice_id": "inv_200002",
  "status": "paid",
  "total": 5.15,
  "next_due_date": "2026-12-02"
}
GET /datacenter/proxies

डेटासेंटर प्रॉक्सी की लिस्ट

अकाउंट के हर डेटासेंटर ऑर्डर को, हर एक के लाइव प्रॉक्सी क्रेडेंशियल के साथ लौटाता है। हर ऑर्डर का id स्थिर है: हर कॉल पर वही ऑर्डर वही ord_... लौटाता है और वह ID आगे भी उसी ऑर्डर तक ले जाती है, इसलिए आप उसे सेव कर सकते हैं। लिस्ट का क्रम तय नहीं है — ID से मिलान करें, लिस्ट में जगह से नहीं।

ऑथेंटिकेशन · Bearer
रिक्वेस्ट GET /datacenter/proxies
curl -X GET "https://api.proxywing.com/v1/datacenter/proxies" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
रिस्पॉन्स 200 · application/json
{
  "orders": [
    {
      "id": "ord_100001",
      "location": "UK",
      "status": "active",
      "expires_at": "2026-08-02T10:14:00",
      "proxies": [
        {
          "id": "prx_8fJ2Wm4Qx1Pv7Ra0Ub9c",
          "ip": "203.0.113.60",
          "http_port": 47668,
          "socks_port": 47669,
          "username": "SAMPLEU1",
          "password": "sample_password",
          "location": "UK",
          "expires_at": "2026-08-02T10:14:00"
        }
      ]
    }
  ]
}
POST /datacenter/orders/{ord_id}/change-password

प्रॉक्सी का पासवर्ड बदलें

किसी ऑर्डर का प्रॉक्सी ऑथेंटिकेशन पासवर्ड रोटेट करता है। पुराने पासवर्ड वाले मौजूदा सेशन तुरंत काम करना बंद कर देते हैं।

ऑथेंटिकेशन · Bearer

पथ पैरामीटर

  • ord_id string ज़रूरी

    उस ऑर्डर की ID जिसका प्रॉक्सी पासवर्ड रोटेट करना है।

रिक्वेस्ट POST /datacenter/orders/{ord_id}/change-password
curl -X POST "https://api.proxywing.com/v1/datacenter/orders/{ord_id}/change-password" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
रिस्पॉन्स 200 · application/json
{
  "status": "password_changed"
}
GET /datacenter/orders/{ord_id}/whitelist

व्हाइटलिस्ट किए गए IP की लिस्ट

किसी डेटासेंटर ऑर्डर पर अभी व्हाइटलिस्ट किए गए IP लौटाता है (वे IP जो बिना यूज़रनेम/पासवर्ड के प्रॉक्सी इस्तेमाल कर सकते हैं)।

ऑथेंटिकेशन · Bearer

पथ पैरामीटर

  • ord_id string ज़रूरी

    ऑर्डर ID, GET /datacenter/proxies से।

रिक्वेस्ट GET /datacenter/orders/{ord_id}/whitelist
curl -X GET "https://api.proxywing.com/v1/datacenter/orders/{ord_id}/whitelist" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
रिस्पॉन्स 200 · application/json
{
  "order_id": "ord_100001",
  "ips": [
    "203.0.113.9",
    "203.0.113.10"
  ]
}
POST /datacenter/orders/{ord_id}/whitelist

IP व्हाइटलिस्ट करें

ऑर्डर की व्हाइटलिस्ट में एक IP पता जोड़ता है, जिससे बिना यूज़रनेम/पासवर्ड के IP से ऑथेंटिकेटेड एक्सेस मिलता है।

ऑथेंटिकेशन · Bearer

पथ पैरामीटर

  • ord_id string ज़रूरी

    उस ऑर्डर की ID जिस पर IP व्हाइटलिस्ट करना है।

बॉडी पैरामीटर

  • ip string ज़रूरी

    व्हाइटलिस्ट करने के लिए IPv4 या IPv6 पता, जैसे 203.0.113.9।

रिक्वेस्ट POST /datacenter/orders/{ord_id}/whitelist
curl -X POST "https://api.proxywing.com/v1/datacenter/orders/{ord_id}/whitelist" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"ip":"203.0.113.9"}'
रिस्पॉन्स 200 · application/json
{
  "status": "whitelisted",
  "ip": "203.0.113.9"
}
DELETE /datacenter/orders/{ord_id}/whitelist/{ip}

व्हाइटलिस्ट किया गया IP हटाएं

डेटासेंटर ऑर्डर की व्हाइटलिस्ट से IP हटाता है और नतीजे में बनी व्हाइटलिस्ट लौटाता है। आइडेम्पोटेंट — जो IP व्हाइटलिस्ट में नहीं है उसे हटाने पर भी 200 लौटता है, इसलिए टाइमआउट के बाद दोबारा कोशिश करना सुरक्षित है। अगर एंट्री हमारे रिकॉर्ड से हट गई है लेकिन प्रॉक्सी ने अभी बदलाव लागू नहीं किया है, तो 503 whitelist_sync_pending लौटता है; तब तक वह IP स्वीकार हो सकता है, इसलिए पुष्टि के लिए दोबारा कोशिश करें।

ऑथेंटिकेशन · Bearer

पथ पैरामीटर

  • ord_id string ज़रूरी

    ऑर्डर ID, GET /datacenter/proxies से।

  • ip string ज़रूरी

    हटाया जाने वाला व्हाइटलिस्ट किया गया IP, जैसे 203.0.113.9।

रिक्वेस्ट DELETE /datacenter/orders/{ord_id}/whitelist/{ip}
curl -X DELETE "https://api.proxywing.com/v1/datacenter/orders/{ord_id}/whitelist/{ip}" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
रिस्पॉन्स 200 · application/json
{
  "order_id": "ord_100001",
  "ips": [
    "203.0.113.10"
  ]
}