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

ProxyWing डेवलपर API

ISP

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

GET /isp/products

ISP प्रोडक्ट की लिस्ट

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

ऑथेंटिकेशन · Bearer
रिक्वेस्ट GET /isp/products
curl -X GET "https://api.proxywing.com/v1/isp/products" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
रिस्पॉन्स 200 · application/json
{
  "products": [
    {
      "product_id": "prod_368",
      "category": "isp",
      "group": "ISP US New York Premium",
      "name": "1 Proxy ISP US",
      "price_monthly": 3
    }
  ]
}
POST /isp/orders

ISP प्रॉक्सी ऑर्डर करें

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

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

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

  • product_id string ज़रूरी

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

  • billing_cycle string वैकल्पिक

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

  • promo_code string वैकल्पिक

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

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

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

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

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

पथ पैरामीटर

  • ord_id string ज़रूरी

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

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

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

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

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

पथ पैरामीटर

  • ord_id string ज़रूरी

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

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

  • cycle integer ज़रूरी

    अवधि कितने महीने बढ़ानी है: 1, 3, 6 या 12।

  • cycle_type string ज़रूरी

    "monthly" ही होना चाहिए।

रिक्वेस्ट POST /isp/orders/{ord_id}/extend
curl -X POST "https://api.proxywing.com/v1/isp/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_100010",
  "invoice_id": "inv_200012",
  "status": "paid",
  "total": 8.55,
  "next_due_date": "2026-12-02"
}
GET /isp/proxies

ISP प्रॉक्सी की लिस्ट

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

ऑथेंटिकेशन · Bearer
रिक्वेस्ट GET /isp/proxies
curl -X GET "https://api.proxywing.com/v1/isp/proxies" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"
रिस्पॉन्स 200 · application/json
{
  "orders": [
    {
      "id": "ord_100010",
      "location": "US",
      "status": "active",
      "expires_at": "2026-08-02T00:00:00+00:00",
      "proxies": [
        {
          "id": "prx_9Km2Wq4Xv1Pb7Ra0Uc8d",
          "ip": "203.0.113.20",
          "http_port": 8080,
          "socks_port": 1080,
          "username": "ISPSAMPLE",
          "password": "sample_password",
          "location": "US",
          "expires_at": "2026-08-02T00:00:00+00:00"
        }
      ]
    }
  ]
}
POST /isp/orders/{ord_id}/change-password

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

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

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

पथ पैरामीटर

  • ord_id string ज़रूरी

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

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

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

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

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

पथ पैरामीटर

  • ord_id string ज़रूरी

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

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

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

IP से ऑथेंटिकेटेड एक्सेस के लिए ISP ऑर्डर की व्हाइटलिस्ट में एक IP पता जोड़ता है।

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

पथ पैरामीटर

  • ord_id string ज़रूरी

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

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

  • ip string ज़रूरी

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

रिक्वेस्ट POST /isp/orders/{ord_id}/whitelist
curl -X POST "https://api.proxywing.com/v1/isp/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 /isp/orders/{ord_id}/whitelist/{ip}

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

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

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

पथ पैरामीटर

  • ord_id string ज़रूरी

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

  • ip string ज़रूरी

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

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