কনটেন্টে যান
hiproxy
শুরু করুন

HiProxy API গাইড

ড্যাশবোর্ডে যা করেন, তা নিজের কোড থেকেও করতে পারেন। ব্যালান্স ও সংযোগের তথ্য দেখা, দাম যাচাই, ব্যালান্স থেকে অর্ডার এবং অপশনসহ প্রক্সি ইউজারনেম তৈরি, সবই REST API দিয়ে।

API কী নিনএন্ডপয়েন্ট দেখুন

কীভাবে শুরু করব?

  1. 1ইউজারনেম দিয়ে সাইন আপ করে ড্যাশবোর্ডে লগ ইন করুন।
  2. 2Connect ট্যাবে একটি 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 401কোনো API কী পাঠানো হয়নি, অথবা কী ভুল।
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-এ IP-এর সংখ্যা (1~1,000) বা datacenter-এ (5~5,000)।
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-এ IP-এর সংখ্যা (1~1,000) বা datacenter-এ (5~5,000)।
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 কী ইস্যু করুন, ব্যস প্রস্তুত।

অ্যাকাউন্ট খুলুনসেটআপ গাইড