सामग्री पर जाएं
hiproxy
शुरू करें

HiProxy API गाइड

जो आप डैशबोर्ड में करते हैं, वह अपने कोड से भी कर सकते हैं। बैलेंस और कनेक्शन जानकारी पढ़ें, कीमतें देखें, बैलेंस से ऑर्डर करें और विकल्पों के साथ प्रॉक्सी यूज़रनेम बनाएं, सब REST API से।

API कुंजी पाएंएंडपॉइंट देखें

शुरुआत कैसे करें?

  1. 1यूज़रनेम से साइन अप करें और डैशबोर्ड में लॉग इन करें।
  2. 2"कनेक्ट" टैब में API कुंजी बनाएं। पूरी कुंजी सिर्फ़ एक बार दिखती है, इसलिए उसे तुरंत किसी सुरक्षित जगह सेव करें।
  3. 3जिस भी अनुरोध में कुंजी चाहिए, उसके Authorization हेडर में कुंजी डालें।
  4. 4कुंजी काम कर रही है यह पक्का करने के लिए पहले /account कॉल करें, फिर /orders से ऑर्डर करें।

ऑथेंटिकेशन कैसे काम करता है?

आपके अपने अकाउंट से जुड़े अनुरोधों (account, orders, proxy-user) के लिए API कुंजी चाहिए। इसे हेडर में Authorization: Bearer hpk_... के रूप में भेजें। कीमतें, देश और कीमत का अनुमान सबके लिए खुले हैं, इनके लिए कुंजी नहीं चाहिए।

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

HTTP header
Authorization: Bearer hpk_your_api_key

बेस URL और डेटा फ़ॉर्मैट

बेस URL
https://hiproxy.shop/api/v1
अनुरोध और जवाब की बॉडी
application/json
रकम
USD संख्या के रूप में, जैसे 1036.60
टाइमस्टैम्प
ISO 8601 (UTC)

क्या रेट लिमिट हैं?

हर API कुंजी से प्रति मिनट 60 कॉल तक किए जा सकते हैं। बिना कुंजी कॉल किए गए पब्लिक एंडपॉइंट पर प्रति IP प्रति मिनट 60 कॉल की अनुमति है। सीमा पार करने पर HTTP 429 मिलता है। एक मिनट रुकें, फिर दोबारा भेजें।

एरर वाला जवाब कैसा दिखता है?

आपको HTTP स्टेटस कोड के साथ एक JSON बॉडी मिलती है, जिसमें छोटा एरर कोड और मैसेज होता है।

उदाहरण
{
  "error": {
    "code": "insufficient_balance",
    "message": "Your balance is too low for this order. Top up in the dashboard."
  }
}
code
bad_requestHTTP 400कोई ज़रूरी मान नहीं है, या यह प्रोडक्ट इस मान को स्वीकार नहीं करता।
unauthorizedHTTP 401API कुंजी नहीं भेजी गई, या कुंजी गलत है।
insufficient_balanceHTTP 402आपका बैलेंस ऑर्डर की कुल रकम से कम है। आपके बैलेंस को छुआ नहीं गया।
not_foundHTTP 404आपके अकाउंट में इस id वाला कोई ऑर्डर नहीं है।
rate_limitedHTTP 429आपने प्रति मिनट अनुरोधों की सीमा पार कर दी।
server_errorHTTP 500सर्वर अनुरोध पूरा नहीं कर सका। आपके बैलेंस को छुआ नहीं गया।

एंडपॉइंट

अपना अकाउंट पढ़ें

GET/api/v1/accountAPI कुंजी ज़रूरी

आपका बैलेंस, प्रॉक्सी होस्ट और पोर्ट, प्रॉक्सी यूज़रनेम और पासवर्ड, और अनुमत IP सूची दिखाता है।

अनुरोध
curl https://hiproxy.shop/api/v1/account \
  -H "Authorization: Bearer hpk_your_api_key"
जवाब
{
  "username": "hi_user01",
  "balance_usd": 1300,
  "proxy": {
    "host": "gate.hiproxy.shop",
    "http_port": 6100,
    "socks5_port": 6200,
    "username": "hpexample1",
    "password": "your_password"
  },
  "allowed_ips": [
    "203.0.113.10"
  ]
}

प्रोडक्ट और कीमतें पढ़ें

GET/api/v1/productsकुंजी नहीं

हर प्रोडक्ट की ऑर्डर सीमा, हर स्तर की कीमत और अवधि की छूट दिखाता है। यह कीमतें पेज वाली ही कीमत टेबल इस्तेमाल करता है।

अनुरोध
curl https://hiproxy.shop/api/v1/products
जवाब
{
  "currency": "USD",
  "prices_as_of": "2026-10-31",
  "products": [
    {
      "id": "unlimited",
      "unit": "day",
      "quantity": {
        "meaning": "days",
        "min": 1,
        "max": 365
      },
      "...": "..."
    },
    {
      "id": "residential",
      "unit": "gb",
      "...": "..."
    }
  ]
}

देशों और शहरों की सूची

GET/api/v1/countriesकुंजी नहीं

हर प्रोडक्ट में उपलब्ध देश और -city- यूज़रनेम विकल्प में इस्तेमाल होने वाले शहर के मान दिखाता है।

फ़ील्डइसका मतलब
productवैकल्पिकunlimited, residential, isp, datacenter में से एक। खाली छोड़ने पर residential।
अनुरोध
curl "https://hiproxy.shop/api/v1/countries?product=datacenter"
जवाब
{
  "product": "datacenter",
  "countries": [
    {
      "code": "us",
      "name": "United States",
      "region": "americas",
      "datacenter": true,
      "cities": [
        {
          "name": "New York",
          "value": "new_york"
        },
        {
          "name": "Los Angeles",
          "value": "los_angeles"
        }
      ]
    }
  ]
}

कीमत का अनुमान पाएं

POST/api/v1/quoteकुंजी नहीं

आपके बैलेंस को छुए बिना ऑर्डर की कुल रकम निकालता है। वही बॉडी भेजें जो आप ऑर्डर करते समय भेजते।

फ़ील्डइसका मतलब
productज़रूरीunlimited, residential, isp, datacenter में से एक।
quantityज़रूरीunlimited के लिए दिन (1~365), residential के लिए GB (5~5,000), isp (1~1,000) या datacenter (5~5,000) के लिए IP की संख्या।
concurrencyवैकल्पिकसिर्फ़ unlimited के लिए। 200, 500, 1000 या 2000 चुनें।
bandwidthवैकल्पिकसिर्फ़ unlimited के लिए, Mbps में। 100, 200, 500 या 1000 चुनें।
monthsवैकल्पिकसिर्फ़ isp और datacenter के लिए। 1, 3, 6 या 12 चुनें।
countryवैकल्पिकसिर्फ़ isp और datacenter के लिए। दो अक्षरों का देश कोड, जैसे jp। मान्य मान /countries में दिए हैं।
अनुरोध
curl -X POST https://hiproxy.shop/api/v1/quote \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'
जवाब
{
  "product": "unlimited",
  "quantity": 30,
  "unit_price_usd": 8.78,
  "unit": "day",
  "total_usd": 263.4
}

ऑर्डर करें

POST/api/v1/ordersAPI कुंजी ज़रूरी

कुल रकम आपके बैलेंस से काटकर ऑर्डर बनाता है। यह pending (सक्रिय हो रहा है) से शुरू होता है और तैयार होने पर active हो जाता है। जो ऑर्डर सक्रिय नहीं हो पाता, वह refunded हो जाता है, और आपकी चुकाई सारी रकम बैलेंस में लौट आती है। बैलेंस कम हो तो 402 मिलता है।

फ़ील्डइसका मतलब
productज़रूरीunlimited, residential, isp, datacenter में से एक।
quantityज़रूरीunlimited के लिए दिन (1~365), residential के लिए GB (5~5,000), isp (1~1,000) या datacenter (5~5,000) के लिए IP की संख्या।
concurrencyवैकल्पिकसिर्फ़ unlimited के लिए। 200, 500, 1000 या 2000 चुनें।
bandwidthवैकल्पिकसिर्फ़ unlimited के लिए, Mbps में। 100, 200, 500 या 1000 चुनें।
monthsवैकल्पिकसिर्फ़ isp और datacenter के लिए। 1, 3, 6 या 12 चुनें।
countryवैकल्पिकसिर्फ़ isp और datacenter के लिए। दो अक्षरों का देश कोड, जैसे jp। मान्य मान /countries में दिए हैं।
अनुरोध
curl -X POST https://hiproxy.shop/api/v1/orders \
  -H "Authorization: Bearer hpk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'
जवाब
{
  "order": {
    "id": "HP-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.78,
    "total_usd": 263.4,
    "status": "pending",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:12:44.120Z"
  },
  "balance_usd": 1036.6
}

ऑर्डर की सूची

GET/api/v1/ordersAPI कुंजी ज़रूरी

आपके 100 तक ऑर्डर दिखाता है, सबसे नए पहले।

फ़ील्डइसका मतलब
statusवैकल्पिकpending, active, refunded में से एक। खाली छोड़ने पर किसी भी स्थिति के ऑर्डर आते हैं।
अनुरोध
curl "https://hiproxy.shop/api/v1/orders?status=pending" \
  -H "Authorization: Bearer hpk_your_api_key"
जवाब
{
  "orders": [
    {
      "id": "HP-7KQ2M-X4HTD",
      "product": "unlimited",
      "quantity": 30,
      "months": null,
      "concurrency": 1000,
      "bandwidth_mbps": 200,
      "country": null,
      "unit_price_usd": 8.78,
      "total_usd": 263.4,
      "status": "pending",
      "created_at": "2026-10-31T09:12:44.120Z",
      "updated_at": "2026-10-31T09:12:44.120Z"
    }
  ]
}

एक ऑर्डर पढ़ें

GET/api/v1/orders/{id}API कुंजी ज़रूरी

id से एक ऑर्डर दिखाता है। सक्रियण पूरा हुआ या नहीं, यह जांचने में काम आता है।

फ़ील्डइसका मतलब
idज़रूरीऑर्डर id, जैसे HP-7KQ2M-X4HTD।
अनुरोध
curl https://hiproxy.shop/api/v1/orders/HP-7KQ2M-X4HTD \
  -H "Authorization: Bearer hpk_your_api_key"
जवाब
{
  "order": {
    "id": "HP-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.78,
    "total_usd": 263.4,
    "status": "active",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:40:02.511Z"
  }
}

प्रॉक्सी यूज़रनेम बनाएं

GET/api/v1/proxy-userAPI कुंजी ज़रूरी

आपके विकल्पों वाला प्रॉक्सी यूज़रनेम देता है, साथ में HTTP और SOCKS5 URL जिन्हें सीधे पेस्ट कर सकते हैं। session के बिना हर अनुरोध पर IP बदलता है।

फ़ील्डइसका मतलब
productवैकल्पिकunlimited, residential, isp, datacenter में से एक। खाली छोड़ने पर unlimited।
countryवैकल्पिकदो अक्षर का देश कोड, जैसे jp।
cityवैकल्पिक/countries से शहर का मान, जैसे tokyo। सिर्फ़ country के साथ काम करता है।
sessionवैकल्पिक1~32 अक्षर या अंक। एक ही session वाले अनुरोध एक ही IP इस्तेमाल करते हैं।
ttlवैकल्पिकसेशन IP कितने मिनट रखना है, 1~60। खाली छोड़ने पर 30।
अनुरोध
curl "https://hiproxy.shop/api/v1/proxy-user?product=residential&country=jp&city=tokyo&session=job42&ttl=30" \
  -H "Authorization: Bearer hpk_your_api_key"
जवाब
{
  "username": "hpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30",
  "password": "your_password",
  "http": "http://hpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.hiproxy.shop:6100",
  "socks5": "socks5h://hpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.hiproxy.shop:6200"
}

चरण दर चरण उदाहरण

एक स्क्रिप्ट जो कीमत जांचती है, बैलेंस से ऑर्डर करती है और जापानी IP से कनेक्ट करती है।

Python (requests)
import requests

API = "https://hiproxy.shop/api/v1"
HEAD = {"Authorization": "Bearer hpk_your_api_key"}

# 1) Check the price first
plan = {"product": "residential", "quantity": 100}
print(requests.post(f"{API}/quote", json=plan).json())

# 2) Order from your balance
r = requests.post(f"{API}/orders", json=plan, headers=HEAD)
order = r.json()["order"]
print(order["id"], order["status"])

# 3) Get a username for Japanese IPs
u = requests.get(f"{API}/proxy-user", headers=HEAD,
                 params={"product": "residential", "country": "jp"}).json()
proxies = {"http": u["http"], "https": u["http"]}
print(requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30).json())
Node.js 18+
const API = "https://hiproxy.shop/api/v1";
const HEAD = { Authorization: "Bearer hpk_your_api_key", "Content-Type": "application/json" };

// Check the balance
const acc = await fetch(`${API}/account`, { headers: HEAD }).then((r) => r.json());
console.log(acc.balance_usd);

// Order 7 days of unlimited
const res = await fetch(`${API}/orders`, {
  method: "POST",
  headers: HEAD,
  body: JSON.stringify({ product: "unlimited", quantity: 7, concurrency: 500, bandwidth: 100 }),
});
if (res.status === 402) console.log("Top up first");
else console.log((await res.json()).order.id);

API से दिए गए ऑर्डर डैशबोर्ड के ऑर्डर की तरह ही संभाले जाते हैं और "इतिहास" टैब में दिखते हैं। उदाहरणों में hpk_your_api_key की जगह अपनी API कुंजी डालें।

अपने कोड से HiProxy कॉल करें

यूज़रनेम से साइन अप करें, डैशबोर्ड में API कुंजी बनाएं और आप तैयार हैं।

अकाउंट बनाएंसेटअप गाइड