StarProxy API রেফারেন্স: অ্যাকাউন্ট, অর্ডার ও ইউজারনেম

কোথা থেকে শুরু করব?

1ইউজারনেম দিয়ে সাইন আপ করে ড্যাশবোর্ডে লগ ইন করুন।
2Connect ট্যাবে একটি API কী তৈরি করুন। পুরো কী একবারই, তৈরির সময় দেখানো হয়, তাই সাথে সাথে নিরাপদ জায়গায় রাখুন।
3যেসব রিকোয়েস্টে কী লাগে, প্রতিটির Authorization হেডারে কী পাঠান।
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."
  }
}

HTTP	code	অর্থ
400	bad_requestHTTP 400একটি দরকারি মান নেই, অথবা মানটি এই প্রোডাক্টের জন্য বৈধ নয়।	একটি দরকারি মান নেই, অথবা মানটি এই প্রোডাক্টের জন্য বৈধ নয়।
401	unauthorizedHTTP 401API কী নেই বা মিলছে না।	API কী নেই বা মিলছে না।
402	insufficient_balanceHTTP 402আপনার ব্যালান্স অর্ডারের মোটের চেয়ে কম। কিছুই কাটা হয়নি।	আপনার ব্যালান্স অর্ডারের মোটের চেয়ে কম। কিছুই কাটা হয়নি।
404	not_foundHTTP 404আপনার অ্যাকাউন্টে এই id-র কোনো অর্ডার নেই।	আপনার অ্যাকাউন্টে এই id-র কোনো অর্ডার নেই।
429	rate_limitedHTTP 429এক মিনিটে অনেক বেশি রিকোয়েস্ট।	এক মিনিটে অনেক বেশি রিকোয়েস্ট।
500	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`ঐচ্ছিক	string	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`আবশ্যিক	string	unlimited, residential, isp, datacenter-এর একটি।
`quantity`আবশ্যিক	integer	unlimited-এ দিন (1~365), residential-এ GB (5~5,000), isp-এ IP-র সংখ্যা (1~1,000) বা datacenter-এ (5~5,000)।
`concurrency`ঐচ্ছিক	integer	শুধু unlimited-এ। 200, 500, 1000, 2000-এর একটি।
`bandwidth`ঐচ্ছিক	integer	শুধু unlimited-এ, Mbps-এ। 100, 200, 500, 1000-এর একটি।
`months`ঐচ্ছিক	integer	শুধু isp ও datacenter-এ। 1, 3, 6, 12-এর একটি।
`country`ঐচ্ছিক	string	শুধু 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`আবশ্যিক	string	unlimited, residential, isp, datacenter-এর একটি।
`quantity`আবশ্যিক	integer	unlimited-এ দিন (1~365), residential-এ GB (5~5,000), isp-এ IP-র সংখ্যা (1~1,000) বা datacenter-এ (5~5,000)।
`concurrency`ঐচ্ছিক	integer	শুধু unlimited-এ। 200, 500, 1000, 2000-এর একটি।
`bandwidth`ঐচ্ছিক	integer	শুধু unlimited-এ, Mbps-এ। 100, 200, 500, 1000-এর একটি।
`months`ঐচ্ছিক	integer	শুধু isp ও datacenter-এ। 1, 3, 6, 12-এর একটি।
`country`ঐচ্ছিক	string	শুধু 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`ঐচ্ছিক	string	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`আবশ্যিক	string	অর্ডারের 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`ঐচ্ছিক	string	unlimited, residential, isp, datacenter-এর একটি। ডিফল্ট unlimited।
`country`ঐচ্ছিক	string	দুই অক্ষরের দেশের কোড, যেমন jp।
`city`ঐচ্ছিক	string	/countries থেকে একটি শহরের মান, যেমন tokyo। country লাগবে।
`session`ঐচ্ছিক	string	1~32টি অক্ষর বা সংখ্যা। একই session-এর রিকোয়েস্ট একটি IP ভাগ করে।
`ttl`ঐচ্ছিক	integer	সেশনের 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

কোথা থেকে শুরু করব?

অথেন্টিকেশন

বেস URL ও ডেটার ফরম্যাট

রেট লিমিট আছে কি?

এরর দেখতে কেমন?

অ্যাকাউন্টের তথ্য

প্রোডাক্ট ও দাম

দেশ ও শহরের তালিকা

দামের হিসাব নিন

অর্ডার তৈরি করুন

অর্ডারের তালিকা

একটি অর্ডার দেখুন

প্রক্সি ইউজারনেম তৈরি করুন

পূর্ণ উদাহরণ

সরাসরি আপনার কোড থেকে StarProxy ব্যবহার করুন