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

डॉक्यूमेंटेशन पर वापस जाएं API रेफ़रेंस v1 api.proxywing.com/v1

ProxyWing डेवलपर API

अकाउंट

प्रोफ़ाइल, वॉलेट बैलेंस, इनवॉइस, सेवाएं, ऑटो-रिन्यू और API कुंजी मैनेजमेंट।

GET /account/me

अकाउंट प्रोफ़ाइल पाएं

उस अकाउंट की प्रोफ़ाइल लौटाता है जिसकी API कुंजी से रिक्वेस्ट ऑथेंटिकेट की गई है।

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

रिक्वेस्ट GET /account/me

curl -X GET "https://api.proxywing.com/v1/account/me" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

रिस्पॉन्स 200 · application/json

{
  "email": "customer@example.com",
  "name": "Jane Doe",
  "country": "US",
  "currency": "USD",
  "status": "active"
}

GET /account/balance

अकाउंट बैलेंस पाएं

अकाउंट का मौजूदा वॉलेट बैलेंस लौटाता है।

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

रिक्वेस्ट GET /account/balance

curl -X GET "https://api.proxywing.com/v1/account/balance" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

रिस्पॉन्स 200 · application/json

{
  "balance": 42.5,
  "currency": "USD"
}

GET /account/invoices

इनवॉइस की लिस्ट

अकाउंट के इनवॉइस लौटाता है, सबसे नए पहले। हर कॉल में ज़्यादा से ज़्यादा limit इनवॉइस लौटते हैं (डिफ़ॉल्ट 1000); total इनवॉइस की कुल संख्या है, इसलिए अगर अकाउंट में इससे ज़्यादा इनवॉइस हैं तो offset से पेजिनेशन करें।

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

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

limit integer वैकल्पिक

ज़्यादा से ज़्यादा कितने इनवॉइस लौटाने हैं, 1–1000। डिफ़ॉल्ट 1000।
offset integer वैकल्पिक

पेजिनेशन के लिए छोड़े जाने वाले इनवॉइस की संख्या। डिफ़ॉल्ट 0।
status string वैकल्पिक

सिर्फ़ इस स्टेटस वाले इनवॉइस लौटाएं: "paid", "unpaid", "overdue", "cancelled", "refunded", "collections" या "payment_pending"। सेट होने पर `total` मेल खाने वाले इनवॉइस की संख्या होती है।

रिक्वेस्ट GET /account/invoices

curl -X GET "https://api.proxywing.com/v1/account/invoices" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

रिस्पॉन्स 200 · application/json

{
  "invoices": [
    {
      "id": "inv_200001",
      "status": "paid",
      "date": "2026-06-02",
      "due_date": "2026-06-02",
      "total": 1.8,
      "currency": "USD"
    }
  ],
  "total": 1
}

GET /account/services

सेवाओं की लिस्ट

अकाउंट की हर सेवा (प्रॉक्सी ऑर्डर, VPN प्लान आदि) लौटाता है। family उस प्रोडक्ट ग्रुप का नाम है जिससे सेवा जुड़ी है।

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

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

status string वैकल्पिक

सिर्फ़ इस स्टेटस वाली सेवाएं लौटाएं, जैसे "active", "suspended", "terminated" या "cancelled"। सब कुछ देखने के लिए इसे न भेजें।

रिक्वेस्ट GET /account/services

curl -X GET "https://api.proxywing.com/v1/account/services" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

रिस्पॉन्स 200 · application/json

{
  "services": [
    {
      "id": "svc_100001",
      "product": "1 Proxy DC UK",
      "family": "Proxy UK",
      "status": "active",
      "next_due_date": "2026-08-02",
      "billing_cycle": "monthly"
    }
  ]
}

GET /account/services/{svc_id}/auto-renew

ऑटो-रिन्यू स्टेटस पाएं

बताता है कि किसी सेवा के लिए ऑटो-रिन्यू चालू है या नहीं। चालू होने पर रिन्यूअल इनवॉइस देय होते ही अकाउंट बैलेंस से अपने-आप चुका दिए जाते हैं।

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

पथ पैरामीटर

svc_id string ज़रूरी

सेवा ID, जैसे svc_100001, GET /account/services से।

रिक्वेस्ट GET /account/services/{svc_id}/auto-renew

curl -X GET "https://api.proxywing.com/v1/account/services/{svc_id}/auto-renew" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

रिस्पॉन्स 200 · application/json

{
  "service_id": "svc_100001",
  "enabled": false
}

PUT /account/services/{svc_id}/auto-renew

ऑटो-रिन्यू सेट करें

किसी सेवा के लिए ऑटो-रिन्यू चालू या बंद करता है। यह सिर्फ़ सेटिंग बदलता है; न कोई इनवॉइस बनाता है, न उसे चुकाता है।

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

पथ पैरामीटर

svc_id string ज़रूरी

सेवा ID, जैसे svc_100001।

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

enabled boolean ज़रूरी

ऑटो-रिन्यू चालू करने के लिए true, बंद करने के लिए false।

रिक्वेस्ट PUT /account/services/{svc_id}/auto-renew

curl -X PUT "https://api.proxywing.com/v1/account/services/{svc_id}/auto-renew" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"enabled":true}'

रिस्पॉन्स 200 · application/json

{
  "service_id": "svc_100001",
  "enabled": true
}

GET /account/api-keys

API कुंजियों की लिस्ट

अकाउंट की हर API कुंजी लौटाता है। सीक्रेट कुंजी कभी नहीं लौटाई जाती — सिर्फ़ वह प्रीफ़िक्स लौटता है जिससे कुंजी पहचानी जाती है।

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

रिक्वेस्ट GET /account/api-keys

curl -X GET "https://api.proxywing.com/v1/account/api-keys" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

रिस्पॉन्स 200 · application/json

{
  "api_keys": [
    {
      "public_id": "key_3Nb8Qv1Xk2Rf9Ta6Ue0p",
      "key_prefix": "pk_live_3Nb8",
      "label": "Production server",
      "scopes": "write",
      "status": "active"
    }
  ]
}

DELETE /account/api-keys/{key_pub_id}

API कुंजी रद्द करें

API कुंजी को तुरंत रद्द करता है। उस कुंजी का इस्तेमाल कर रही सभी रिक्वेस्ट उसी समय 401 के साथ फ़ेल होने लगती हैं। यह कार्रवाई वापस नहीं ली जा सकती।

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

पथ पैरामीटर

key_pub_id string ज़रूरी

रद्द की जाने वाली कुंजी की सार्वजनिक ID, जैसे key_3Nb8Qv1Xk2Rf9Ta6Ue0p।

रिक्वेस्ट DELETE /account/api-keys/{key_pub_id}

curl -X DELETE "https://api.proxywing.com/v1/account/api-keys/{key_pub_id}" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

रिस्पॉन्स 200 · application/json

{
  "revoked": "key_3Nb8Qv1Xk2Rf9Ta6Ue0p"
}