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

ProxyWing डेवलपर API

प्रोडक्ट और ऑर्डर

फ़िक्स्ड कीमत वाले डेटासेंटर और ISP कैटलॉग देखें और अपने बैलेंस से ऑर्डर करें।

GET /products

फ़िक्स्ड कीमत वाले प्रोडक्ट की लिस्ट

फ़िक्स्ड कीमत वाले प्रोडक्ट का कैटलॉग लौटाता है — हर लोकेशन के डेटासेंटर और ISP प्रॉक्सी — जिन्हें POST /orders से ऑर्डर किया जा सकता है। price_monthly मासिक दर है; लंबी बिलिंग अवधि (तिमाही/छमाही/सालाना) billing_cycle भेजकर ऑर्डर की जाती है और उसका बिल प्रोडक्ट की प्रति-अवधि छूट वाली कीमत पर बनता है। रेजिडेंशियल ट्रैफ़िक (कीमत प्रति GB) और मोबाइल प्रॉक्सी (कीमत अवधि के हिसाब से) के अपने कैटलॉग हैं: GET /residential/products और GET /mobile/products देखें।

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

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

  • category string वैकल्पिक

    प्रोडक्ट ग्रुप के हिसाब से फ़िल्टर करें, फ़िलहाल "datacenter" या "isp"। सब कुछ देखने के लिए इसे न भेजें; अनजान वैल्यू पर बस खाली लिस्ट लौटती है।

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

प्रोडक्ट ऑर्डर करें

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

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

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

  • product_id string ज़रूरी

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

  • billing_cycle string वैकल्पिक

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

  • promo_code string वैकल्पिक

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

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