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

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

शुरुआत

अकाउंट

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

डेटासेंटर

रेजिडेंशियल

GET रेजिडेंशियल टियर की लिस्ट
POST रेजिडेंशियल ट्रैफ़िक ऑर्डर करें
POST सेवा में बैंडविड्थ जोड़ें
GET रेजिडेंशियल सेवाओं की लिस्ट
GET कनेक्शन क्रेडेंशियल पाएं
GET ट्रैफ़िक इस्तेमाल पाएं
GET इस्तेमाल रिपोर्ट पाएं
GET देशों और शहरों की लिस्ट
GET किसी सेवा के देशों और शहरों की लिस्ट
GET ऑटो-टॉप-अप सेटिंग पाएं
PUT ऑटो-टॉप-अप सेट करें
POST प्रॉक्सी लिस्ट जनरेट करें

सब-यूज़र

ISP

मोबाइल

फ़िंगरप्रिंट

ProxyWing डेवलपर API

रेजिडेंशियल

रेजिडेंशियल ट्रैफ़िक प्रति GB खरीदें, उसे अपने गेटवे होस्टनेम पर चलाएं और इस्तेमाल रिपोर्ट पाएं। सब-यूज़र के ज़रिए रीसेल करने का अलग सेक्शन है।

GET /residential/products

रेजिडेंशियल टियर की लिस्ट

खरीद के लिए उपलब्ध रेजिडेंशियल प्रॉक्सी टियर लौटाता है। रेजिडेंशियल ट्रैफ़िक प्रति गीगाबाइट बिकता है; बड़ी मात्रा पर छूट चेकआउट पर अपने-आप लागू होती है।

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

रिक्वेस्ट GET /residential/products

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

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

{
  "tiers": [
    {
      "tier": "premium",
      "per_gb": 6
    },
    {
      "tier": "standard",
      "per_gb": 2.5
    }
  ]
}

POST /residential/orders

रेजिडेंशियल ट्रैफ़िक ऑर्डर करें

चुने गए टियर पर अकाउंट बैलेंस से रेजिडेंशियल प्रॉक्सी ट्रैफ़िक (GB में) खरीदता है। यह एक बार की खरीद है — कोई बिलिंग अवधि या बार-बार लगने वाला चार्ज नहीं है; ट्रैफ़िक इस्तेमाल होने तक सेवा पर बना रहता है। इनवॉइस की कुल रकम बिलिंग सिस्टम तय करता है — बड़ी मात्रा पर छूट अपने-आप लगती है, इसलिए बड़े ऑर्डर gb × per_gb से सस्ते पड़ सकते हैं। भुगतान होते ही सेवा तुरंत प्रोविज़न होती है और GET /residential/services में दिखती है। Idempotency-Key हेडर भेजें, ताकि दोबारा कोशिश करने पर दो बार पैसे न कटें। रिस्पॉन्स में मिला order_id वही ID है जिसे आप इस संसाधन की हर अगली कॉल में इस्तेमाल करते हैं, और यह ऑर्डर प्रोविज़न होने के बाद ही पता चलता है — जब तक ऑर्डर awaiting_payment में है, यह null रहता है। इनवॉइस चुकाएं, फिर संसाधन पाने के लिए या तो बैलेंस से चुकाए गए ऑर्डर का रिस्पॉन्स दोबारा पढ़ें या संबंधित लिस्ट एंडपॉइंट को बार-बार जांचें। इस एंडपॉइंट पर Idempotency-Key ज़रूरी है — इसके बिना 400 लौटता है और कुछ भी चार्ज नहीं होता।

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

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

tier string ज़रूरी

"premium" या "standard", GET /residential/products से।
gb integer ज़रूरी

खरीदने के लिए ट्रैफ़िक, गीगाबाइट में (1–1000)।
promo_code string वैकल्पिक

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

रिक्वेस्ट POST /residential/orders

curl -X POST "https://api.proxywing.com/v1/residential/orders" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Idempotency-Key: b3f2a1c4-7e9d-4a2b-8c6f-1d5e9a0b3c7f" \
  -H "Content-Type: application/json" \
  -d '{"tier":"standard","gb":5}'

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

{
  "order_id": "resi_100001",
  "invoice_id": "inv_200004",
  "tier": "standard",
  "gb": 5,
  "status": "paid"
}

POST /residential/services/{svc_id}/top-up

सेवा में बैंडविड्थ जोड़ें

पहले से मौजूद रेजिडेंशियल सेवा में GB ट्रैफ़िक जोड़ता है — न नया ऑर्डर, न नए क्रेडेंशियल; अतिरिक्त ट्रैफ़िक उसी सेवा में जुड़ता है। जोड़े गए GB के लिए इनवॉइस बनता है (बड़ी मात्रा पर छूट लागू होती है, इसलिए बड़े टॉप-अप प्रति GB सस्ते पड़ते हैं) और अगर बैलेंस काफ़ी है तो वह अपने-आप चुका दिया जाता है और ट्रैफ़िक तुरंत जुड़ जाता है। अगर बैलेंस कम है तो इनवॉइस खुला रहता है (awaiting_payment) और उसे डैशबोर्ड से चुकाया जा सकता है। Idempotency-Key हेडर भेजें, ताकि दोबारा कोशिश करने पर दो बार खरीदारी न हो। इस एंडपॉइंट पर Idempotency-Key ज़रूरी है — इसके बिना 400 लौटता है और कुछ भी चार्ज नहीं होता।

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

पथ पैरामीटर

svc_id string ज़रूरी

रेजिडेंशियल सेवा ID, जैसे resi_100001, GET /residential/services से।

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

gb integer ज़रूरी

जोड़ने के लिए ट्रैफ़िक, गीगाबाइट में (1–10000)।

रिक्वेस्ट POST /residential/services/{svc_id}/top-up

curl -X POST "https://api.proxywing.com/v1/residential/services/{svc_id}/top-up" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Idempotency-Key: b3f2a1c4-7e9d-4a2b-8c6f-1d5e9a0b3c7f" \
  -H "Content-Type: application/json" \
  -d '{"gb":5}'

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

{
  "service_id": "resi_100001",
  "gb_added": 5,
  "old_gb": 3,
  "new_gb": 8,
  "invoice_id": "inv_200020",
  "total": 11.25,
  "status": "paid"
}

GET /residential/services

रेजिडेंशियल सेवाओं की लिस्ट

अकाउंट की हर सक्रिय रेजिडेंशियल सेवा लौटाता है, उसके टियर और उस गेटवे होस्टनेम के साथ जिससे वह कनेक्ट होती है।

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

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

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

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

{
  "services": [
    {
      "id": "resi_100001",
      "tier": "standard",
      "status": "active",
      "gateway": "quality.proxywing.com"
    },
    {
      "id": "resi_100002",
      "tier": "premium",
      "status": "active",
      "gateway": "premium.proxywing.com"
    }
  ]
}

GET /residential/services/{svc_id}/credentials

कनेक्शन क्रेडेंशियल पाएं

रेजिडेंशियल सेवा के लिए गेटवे, उपलब्ध पोर्ट और यूज़रनेम/पासवर्ड लौटाता है। जब आप प्रॉक्सी स्ट्रिंग हाथ से बनाते हैं, तो targeting_field बताता है कि जियो-टारगेटिंग और सेशन टोकन किस क्रेडेंशियल में जुड़ते हैं — इन्हें अपने-आप बनवाने के लिए POST /residential/services/{svc_id}/generate-proxy-list इस्तेमाल करें।

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

पथ पैरामीटर

svc_id string ज़रूरी

सेवा ID, जैसे resi_100001, GET /residential/services से।

रिक्वेस्ट GET /residential/services/{svc_id}/credentials

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

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

{
  "id": "resi_100001",
  "tier": "standard",
  "gateway": "quality.proxywing.com",
  "http_ports": [
    8888,
    7000,
    7001,
    7002,
    7003,
    7004,
    7005
  ],
  "socks5_ports": [
    1080,
    6000,
    6001,
    6002,
    6003,
    6004,
    6005
  ],
  "username": "pkg-private2",
  "password": "sample_password",
  "targeting_field": "username"
}

GET /residential/services/{svc_id}/traffic

ट्रैफ़िक इस्तेमाल पाएं

रेजिडेंशियल सेवा का ट्रैफ़िक बैलेंस गीगाबाइट में लौटाता है। जिन फ़ील्ड को किसी टियर के लिए ट्रैक नहीं किया जाता, वे null होते हैं।

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

पथ पैरामीटर

svc_id string ज़रूरी

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

रिक्वेस्ट GET /residential/services/{svc_id}/traffic

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

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

{
  "tier": "standard",
  "total_gb": 20,
  "used_gb": 1.21,
  "available_gb": 18.79
}

GET /residential/services/{svc_id}/usage-report

इस्तेमाल रिपोर्ट पाएं

किसी तारीख सीमा में रेजिडेंशियल सेवा का होस्टनेम-वार ट्रैफ़िक इस्तेमाल लौटाता है। वैल्यू मांगी गई unit में होती हैं; total सभी पंक्तियों का जोड़ है।

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

पथ पैरामीटर

svc_id string ज़रूरी

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

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

date_from string ज़रूरी

शुरुआती तारीख, YYYY-MM-DD।
date_to string ज़रूरी

आख़िरी तारीख, YYYY-MM-DD।
unit string वैकल्पिक

डेटा वैल्यू की माप यूनिट: "B", "KB", "MB" या "GB" (डिफ़ॉल्ट GB)।

रिक्वेस्ट GET /residential/services/{svc_id}/usage-report

curl -X GET "https://api.proxywing.com/v1/residential/services/{svc_id}/usage-report" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

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

{
  "tier": "standard",
  "date_from": "2026-06-01",
  "date_to": "2026-07-01",
  "unit": "GB",
  "total": 3.42,
  "rows": [
    {
      "date": "2026-06-15",
      "hostname": "example.com",
      "data": 2.1,
      "requests": 1840
    },
    {
      "date": "2026-06-16",
      "hostname": "api.example.com",
      "data": 1.32,
      "requests": 910
    }
  ]
}

GET /residential/access

देशों और शहरों की लिस्ट

आपको क्या चाहिए, उसके हिसाब से दो कॉल। **देश:** सिर्फ़ tier भेजें — GET /residential/access?tier=premium। **शहर:** country जोड़ें — GET /residential/access?tier=premium&country=US। हर एंट्री में एक code और दिखाने के लिए एक name होता है, और generate-proxy-list को city / country के रूप में **आप code ही भेजते हैं** (losangeles, "Los angeles" नहीं)। टियर के बीच कवरेज में बड़ा अंतर है, इसलिए वही टियर क्वेरी करें जो आप असल में बेचते हैं: losangeles और sanfrancisco प्रीमियम पर हैं लेकिन स्टैंडर्ड पर नहीं, और प्रीमियम में अमेरिका के 2030 शहर हैं जबकि स्टैंडर्ड में 534। लिस्ट में न मौजूद शहर से ऐसा क्रेडेंशियल बनता है जिसे गेटवे अस्वीकार कर देता है, इसलिए अंदाज़ा लगाने की बजाय नाम यहीं से पता करें। **ASN के लिए कोई लिस्टिंग एंडपॉइंट नहीं है** — AS नंबर आपको खुद देना होगा (जैसे Comcast के लिए 7922); generate-proxy-list का isp पैरामीटर देखें।

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

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

tier string ज़रूरी

"premium" या "standard"।
country string वैकल्पिक

ISO देश कोड, जैसे US। सेट होने पर देशों की लिस्ट की जगह उस देश के शहर लौटाता है। इनपुट में बड़े-छोटे अक्षरों से फ़र्क नहीं पड़ता; रिस्पॉन्स में `code` वैल्यू छोटे अक्षरों में होती हैं।

रिक्वेस्ट GET /residential/access

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

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

{
  "tier": "premium",
  "countries": [
    {
      "code": "us",
      "name": "United States"
    },
    {
      "code": "gb",
      "name": "United Kingdom"
    },
    {
      "code": "de",
      "name": "Germany"
    }
  ]
}

GET /residential/services/{svc_id}/access

किसी सेवा के देशों और शहरों की लिस्ट

GET /residential/access वाला ही जियो कैटलॉग, लेकिन आपकी किसी एक सेवा तक सीमित, ताकि आपको उसका टियर जानने या भेजने की ज़रूरत न पड़े। सभी उपलब्ध देशों के लिए इसे बिना पैरामीटर भेजें; उस देश के शहरों के लिए country जोड़ें — नीचे का सैंपल शहरों वाला रूप दिखाता है। code वैल्यू छोटे अक्षरों में होती हैं और generate-proxy-list को city / country के रूप में यही भेजी जाती हैं। सिर्फ़ पढ़ने के स्कोप वाली कुंजियां काफ़ी हैं।

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

पथ पैरामीटर

svc_id string ज़रूरी

रेजिडेंशियल सेवा ID, GET /residential/services से।

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

country string वैकल्पिक

ISO देश कोड, जैसे US। सेट होने पर देशों की लिस्ट की जगह उस देश के शहर लौटाता है।

रिक्वेस्ट GET /residential/services/{svc_id}/access

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

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

{
  "tier": "standard",
  "country": "US",
  "cities": [
    {
      "code": "chicago",
      "name": "Chicago"
    },
    {
      "code": "dallas",
      "name": "Dallas"
    }
  ]
}

GET /residential/services/{svc_id}/auto-topup

ऑटो-टॉप-अप सेटिंग पाएं

रेजिडेंशियल सेवा का ऑटो-टॉप-अप कॉन्फ़िगरेशन लौटाता है। चालू होने पर, बचा हुआ बैलेंस थ्रेशोल्ड से नीचे जाते ही अकाउंट अपने-आप और ट्रैफ़िक खरीद लेता है।

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

पथ पैरामीटर

svc_id string ज़रूरी

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

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

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

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

{
  "service_id": "resi_100001",
  "enabled": true,
  "threshold_gb": 2,
  "amount_gb": 5,
  "payment_source": "balance",
  "last_topup_at": null
}

PUT /residential/services/{svc_id}/auto-topup

ऑटो-टॉप-अप सेट करें

रेजिडेंशियल सेवा के लिए ऑटो-टॉप-अप चालू या बंद करता है। चालू करते समय threshold_gb और amount_gb दोनों ज़रूरी हैं और टॉप-अप का भुगतान अकाउंट बैलेंस से होता है। (कार्ड से भुगतान वाला ऑटो-टॉप-अप डैशबोर्ड से कॉन्फ़िगर किया जाता है।)

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

पथ पैरामीटर

svc_id string ज़रूरी

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

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

enabled boolean ज़रूरी

ऑटो-टॉप-अप चालू करने के लिए true, बंद करने के लिए false।
threshold_gb number वैकल्पिक

बचा हुआ ट्रैफ़िक इतने GB से नीचे जाने पर टॉप-अप करें (1–10000)। चालू करते समय ज़रूरी।
amount_gb number वैकल्पिक

हर बार कितने GB खरीदने हैं (1–10000)। चालू करते समय ज़रूरी।

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

curl -X PUT "https://api.proxywing.com/v1/residential/services/{svc_id}/auto-topup" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"enabled":true,"threshold_gb":2,"amount_gb":5}'

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

{
  "service_id": "resi_100001",
  "enabled": true,
  "threshold_gb": 2,
  "amount_gb": 5,
  "payment_source": "balance",
  "last_topup_at": null
}

POST /residential/services/{svc_id}/generate-proxy-list

प्रॉक्सी लिस्ट जनरेट करें

रेजिडेंशियल सेवा के लिए, आपके बताए जियो-टारगेटिंग और सेशन व्यवहार के साथ, इस्तेमाल के लिए तैयार प्रॉक्सी स्ट्रिंग बनाता है। रोटेटिंग सेशन को हर रिक्वेस्ट पर नया एग्ज़िट IP मिलता है; स्टिकी सेशन सेशन TTL तक वही एग्ज़िट IP रखते हैं। यह एंडपॉइंट सिर्फ़ क्रेडेंशियल फ़ॉर्मैट करता है — यह अकाउंट से कभी पैसे नहीं काटता।

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

पथ पैरामीटर

svc_id string ज़रूरी

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

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

count integer वैकल्पिक

जनरेट करने के लिए प्रॉक्सी स्ट्रिंग की संख्या, 1–1000। डिफ़ॉल्ट 10।
protocol string वैकल्पिक

"http" (डिफ़ॉल्ट), "socks5" या "mix"। "mix" सिर्फ़ स्टैंडर्ड टियर पर है — एक ही पोर्ट HTTP और SOCKS5 दोनों का जवाब देता है; प्रीमियम पर इसे मांगने से 400 लौटता है।
format string वैकल्पिक

आउटपुट फ़ॉर्मैट। इनमें से एक: "hostname:port:username:password" (डिफ़ॉल्ट), "hostname:port@username:password", "username:password@hostname:port", "username:password:hostname:port"।
port integer वैकल्पिक

इस्तेमाल करने के लिए ख़ास गेटवे पोर्ट। यह उस प्रोटोकॉल के लिए प्रकाशित पोर्ट में से एक होना चाहिए — प्रीमियम 102 HTTP और 102 SOCKS5 पोर्ट स्वीकार करता है, स्टैंडर्ड 111 HTTP, 112 SOCKS5 और "mix" के लिए 5555। डिफ़ॉल्ट रूप से `session` के आधार पर टियर का रोटेटिंग या स्टिकी पोर्ट लिया जाता है ("mix" के लिए 5555)।
country string वैकल्पिक

टारगेट करने के लिए ISO देश कोड, जैसे "US", या कई देशों के पूल के लिए "US,GB"। रैंडम देश के लिए इसे न भेजें।
city string वैकल्पिक

टारगेट करने के लिए शहर। इसके लिए ठीक एक `country` ज़रूरी है — कॉमा से अलग किए गए कई देशों वाली वैल्यू होने पर शहर हटा दिया जाता है। दोनों टियर पर उपलब्ध; मान्य नाम `GET /residential/services/{svc_id}/access?country=US` से पता करें (प्रीमियम में स्टैंडर्ड से कहीं ज़्यादा शहर हैं)। स्पेस हटा दिए जाते हैं, इसलिए "Los angeles" `LosAngeles` के रूप में भेजा जाता है।
isp string वैकल्पिक

टारगेट करने के लिए ASN, जैसे Comcast के लिए `7922`। `city` की तरह इसके लिए भी ठीक एक `country` ज़रूरी है, और उसके साथ मिलाकर इससे दोनों तय किए जा सकते हैं (शिकागो में Comcast)। प्रीमियम AS नंबर या प्रदाता का नाम स्वीकार करता है; स्टैंडर्ड को AS नंबर चाहिए। ASN खोजने का कोई एंडपॉइंट नहीं है — AS नंबर आपको खुद देना होगा।
session string वैकल्पिक

"rotating" (डिफ़ॉल्ट) या "sticky"।
session_ttl string वैकल्पिक

स्टिकी सेशन अपना एग्ज़िट IP कितनी देर रखे, जैसे "30s", "10m", "2h", "1d"।
ipv4 boolean वैकल्पिक

सिर्फ़ स्टैंडर्ड टियर: सिर्फ़ IPv4 वाले पूल तक सीमित रखें। डिफ़ॉल्ट true।
streaming boolean वैकल्पिक

सिर्फ़ प्रीमियम टियर: हाई-एंड स्ट्रीमिंग पूल इस्तेमाल करें। डिफ़ॉल्ट false।
direct boolean वैकल्पिक

सिर्फ़ प्रीमियम टियर: डायरेक्ट कनेक्शन मोड, IMAP जैसे उन प्रोटोकॉल के लिए जो डिफ़ॉल्ट रूट के साथ ठीक से काम नहीं करते। डिफ़ॉल्ट false।
skip_static_isp boolean वैकल्पिक

सिर्फ़ प्रीमियम टियर: स्टैटिक ISP एग्ज़िट छोड़ दें। डिफ़ॉल्ट false।
host string वैकल्पिक

DNS गेटवे होस्टनेम की जगह सीधा एंट्री IP दें। यह टियर के प्रकाशित एंट्री IP में से एक होना चाहिए, या टियर गेटवे का नाम; बाकी कुछ भी देने पर 400 लौटता है। ज़रूरत न हो तो इसे खाली छोड़ दें — गेटवे होस्टनेम जियो-रूटेड है, इसलिए IP तय करने से उस स्ट्रिंग का हर यूज़र एक ही क्षेत्र में पहुंचता है। उपलब्ध IP सब-यूज़र क्रेडेंशियल एंडपॉइंट से `entry_ips` के रूप में मिलते हैं।

रिक्वेस्ट POST /residential/services/{svc_id}/generate-proxy-list

curl -X POST "https://api.proxywing.com/v1/residential/services/{svc_id}/generate-proxy-list" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"count":2,"protocol":"http","country":"US","session":"sticky","session_ttl":"10m"}'

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

{
  "gateway": "quality.proxywing.com",
  "port": 8888,
  "protocol": "http",
  "count": 2,
  "proxies": [
    "quality.proxywing.com:8888:pkg-private2-pool-onlyipv4-country-US-session-a1b2c3d4-ttl-10:sample_password",
    "quality.proxywing.com:8888:pkg-private2-pool-onlyipv4-country-US-session-e5f6g7h8-ttl-10:sample_password"
  ]
}

GET /residential/gateways

अपने गेटवे होस्टनेम की लिस्ट

आपके व्हाइट-लेबल गेटवे होस्टनेम, हर टियर के लिए एक, हर एक के लाइव DNS स्टेटस के साथ। कोई होस्टनेम कॉन्फ़िगर न होने पर प्लेटफ़ॉर्म के डिफ़ॉल्ट इस्तेमाल होते हैं और सब कुछ पहले जैसा ही काम करता है।

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

रिक्वेस्ट GET /residential/gateways

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

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

{
  "gateways": [
    {
      "tier": "premium",
      "hostname": "gw.yourdomain.com",
      "status": "active",
      "in_use": true,
      "resolves_to": [
        "149.51.212.54"
      ],
      "expected_ips": [
        "149.51.212.54"
      ],
      "last_checked_at": "2026-07-26T08:17:01Z",
      "error": null
    }
  ],
  "defaults": {
    "premium": "premium.proxywing.com",
    "standard": "quality.proxywing.com"
  }
}

GET /residential/gateways/{tier}/target

जोड़ने के लिए DNS रिकॉर्ड पाएं

आपके अपने होस्टनेम के लिए बनाया जाने वाला सटीक DNS रिकॉर्ड लौटाता है। A रिकॉर्ड नहीं, CNAME इस्तेमाल करें: गेटवे जियो-रूटेड है और रिक्वेस्ट कहां से आ रही है, उसके हिसाब से अलग-अलग पते लौटाता है, ताकि आपका हर ग्राहक पास के एंट्री पॉइंट तक पहुंचे। फ़िक्स्ड A रिकॉर्ड उन सभी को एक ही क्षेत्र से बांध देंगे और जब भी वे पते बदलेंगे, काम करना बंद कर देंगे।

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

पथ पैरामीटर

tier string ज़रूरी

premium या standard में से एक।

रिक्वेस्ट GET /residential/gateways/{tier}/target

curl -X GET "https://api.proxywing.com/v1/residential/gateways/{tier}/target" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

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

{
  "tier": "premium",
  "record_type": "CNAME",
  "target": "premium.proxywing.com",
  "ttl_hint": 300,
  "example": "gw.yourdomain.com.  IN  CNAME  premium.proxywing.com."
}

PUT /residential/gateways/{tier}

अपना गेटवे होस्टनेम सेट करें

किसी टियर को आपके अपने डोमेन के होस्टनेम पर पॉइंट करता है, ताकि आप अपने ग्राहकों को जो क्रेडेंशियल और प्रॉक्सी स्ट्रिंग देते हैं उनमें हमारा नहीं, आपका ब्रांड दिखे। हम DNS तुरंत जांचते हैं: status active का मतलब है कि होस्टनेम लाइव है और अब हर क्रेडेंशियल और प्रॉक्सी लिस्ट रिस्पॉन्स आपका होस्टनेम लौटाता है, जबकि pending का मतलब है कि रिकॉर्ड अभी सही नहीं है और error फ़ील्ड वजह बताता है — जब तक रिकॉर्ड सही नहीं होता, हम डिफ़ॉल्ट गेटवे ही देते रहते हैं, इसलिए गलत कॉन्फ़िगर किया गया रिकॉर्ड आपके ग्राहकों को कभी बेकार प्रॉक्सी नहीं देगा। हर टियर अलग से काम करता है। अगर वह होस्टनेम पहले से किसी दूसरे अकाउंट के पास है, तो 409 hostname_unavailable लौटता है।

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

पथ पैरामीटर

tier string ज़रूरी

premium या standard में से एक।

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

hostname string ज़रूरी

आपके नियंत्रण वाले डोमेन का होस्टनेम, जैसे gw.yourdomain.com।

रिक्वेस्ट PUT /residential/gateways/{tier}

curl -X PUT "https://api.proxywing.com/v1/residential/gateways/{tier}" \
  -H "Authorization: Bearer pk_live_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"hostname":"gw.yourdomain.com"}'

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

{
  "tier": "premium",
  "hostname": "gw.yourdomain.com",
  "status": "active",
  "in_use": true,
  "resolves_to": [
    "149.51.212.54"
  ],
  "expected_ips": [
    "149.51.212.54"
  ],
  "last_checked_at": "2026-07-26T08:17:01Z",
  "error": null
}

POST /residential/gateways/{tier}/verify

अपने गेटवे का DNS दोबारा जांचें

बैकग्राउंड जांच का इंतज़ार किए बिना, इस टियर का DNS तुरंत दोबारा जांचता है। रिकॉर्ड ठीक करने के बाद इसका इस्तेमाल करें। हम खुद भी लगातार दोबारा जांच करते रहते हैं: अगर पहले से काम कर रहा होस्टनेम हमारे गेटवे पर रिज़ॉल्व होना बंद कर दे, तो हम उसे drifted मार्क करते हैं और नई जनरेट होने वाली स्ट्रिंग के लिए डिफ़ॉल्ट पर लौट जाते हैं, फिर रिकॉर्ड दोबारा सही होते ही उसे अपने-आप वापस चालू कर देते हैं।

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

पथ पैरामीटर

tier string ज़रूरी

premium या standard में से एक।

रिक्वेस्ट POST /residential/gateways/{tier}/verify

curl -X POST "https://api.proxywing.com/v1/residential/gateways/{tier}/verify" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

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

{
  "tier": "premium",
  "hostname": "gw.yourdomain.com",
  "status": "active",
  "in_use": true,
  "resolves_to": [
    "149.51.212.54"
  ],
  "expected_ips": [
    "149.51.212.54"
  ],
  "last_checked_at": "2026-07-26T08:29:12Z",
  "error": null
}

DELETE /residential/gateways/{tier}

अपना गेटवे होस्टनेम हटाएं

इस टियर को प्लेटफ़ॉर्म के डिफ़ॉल्ट गेटवे पर वापस ले आता है। आपके अपने होस्टनेम पर पहले से जारी की गई प्रॉक्सी स्ट्रिंग तब तक काम करती रहती हैं, जब तक आपका DNS रिकॉर्ड बना रहता है।

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

पथ पैरामीटर

tier string ज़रूरी

premium या standard में से एक।

रिक्वेस्ट DELETE /residential/gateways/{tier}

curl -X DELETE "https://api.proxywing.com/v1/residential/gateways/{tier}" \
  -H "Authorization: Bearer pk_live_XXXXXXXX"

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

{
  "tier": "premium",
  "hostname": null,
  "serving": "premium.proxywing.com"
}