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

StarProxy API

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

API कुंजी बनाएंएंडपॉइंट सूची

कहां से शुरू करूं?

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

ऑथेंटिकेशन

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

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

HTTP header
Authorization: Bearer spk_your_api_key

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

बेस URL
https://starproxy.shop/api/v1
अनुरोध और जवाब की बॉडी
application/json
रकम
USD संख्या के रूप में, जैसे 1047.70
टाइमस्टैम्प
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://starproxy.shop/api/v1/account \
  -H "Authorization: Bearer spk_your_api_key"
जवाब
{
  "username": "star_user01",
  "balance_usd": 1300,
  "proxy": {
    "host": "gate.starproxy.shop",
    "http_port": 6100,
    "socks5_port": 6200,
    "username": "spexample1",
    "password": "your_password"
  },
  "allowed_ips": [
    "203.0.113.10"
  ]
}

प्रोडक्ट और कीमतें देखें

GET/api/v1/productsकुंजी की ज़रूरत नहीं

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

अनुरोध
curl https://starproxy.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://starproxy.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://starproxy.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.41,
  "unit": "day",
  "total_usd": 252.3
}

ऑर्डर बनाएं

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://starproxy.shop/api/v1/orders \
  -H "Authorization: Bearer spk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'
जवाब
{
  "order": {
    "id": "SP-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.41,
    "total_usd": 252.3,
    "status": "pending",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:12:44.120Z"
  },
  "balance_usd": 1047.7
}

ऑर्डर की सूची

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

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

फ़ील्डमतलब
statusवैकल्पिकpending, active, refunded में से एक। हर स्थिति के लिए इसे खाली छोड़ें।
अनुरोध
curl "https://starproxy.shop/api/v1/orders?status=pending" \
  -H "Authorization: Bearer spk_your_api_key"
जवाब
{
  "orders": [
    {
      "id": "SP-7KQ2M-X4HTD",
      "product": "unlimited",
      "quantity": 30,
      "months": null,
      "concurrency": 1000,
      "bandwidth_mbps": 200,
      "country": null,
      "unit_price_usd": 8.41,
      "total_usd": 252.3,
      "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, जैसे SP-7KQ2M-X4HTD।
अनुरोध
curl https://starproxy.shop/api/v1/orders/SP-7KQ2M-X4HTD \
  -H "Authorization: Bearer spk_your_api_key"
जवाब
{
  "order": {
    "id": "SP-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.41,
    "total_usd": 252.3,
    "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://starproxy.shop/api/v1/proxy-user?product=residential&country=jp&city=tokyo&session=job42&ttl=30" \
  -H "Authorization: Bearer spk_your_api_key"
जवाब
{
  "username": "spexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30",
  "password": "your_password",
  "http": "http://spexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.starproxy.shop:6100",
  "socks5": "socks5h://spexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.starproxy.shop:6200"
}

पूरा उदाहरण

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

Python (requests)
import requests

API = "https://starproxy.shop/api/v1"
HEAD = {"Authorization": "Bearer spk_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://starproxy.shop/api/v1";
const HEAD = { Authorization: "Bearer spk_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 ऑर्डर डैशबोर्ड ऑर्डर की तरह ही प्रोसेस होते हैं और "इतिहास" टैब पर दिखते हैं। उदाहरणों में spk_your_api_key की जगह अपनी कुंजी डालें।

StarProxy को सीधे अपने कोड से इस्तेमाल करें

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

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