প্রোক্সি API ডকুমেন্টেশন: REST API দিয়ে প্রোক্সি তালিকা প্রাপ্তি

API দিয়ে কি করা যায়?

প্রক্সি ব্যবহারকারী প্রোগ্রাম সরাসরি সর্বশেষ তালিকা নিয়ে যেতে API ব্যবহার করে। ক্রলার শুরু করার সময় তালিকা নিয়ে আসুন, নতুন প্ল্যান কিনুন বা সময় শেষ হলে সার্ভার নিজে তালিকা পরিবর্তন করবে। ড্যাশবোর্ড থেকে ডাউনলোড করা তালিকা এবং API দিয়ে নেওয়া তালিকা একই ডেটা।

API শুধু পড়ার জন্য। ব্যালেন্স চেক, প্ল্যান তালিকা, প্রোক্সি তালিকা দেখার জন্য সমর্থন করে, পেমেন্ট এবং ক্রয় ড্যাশবোর্ডে করা হয়। সব রেসপন্স UTF-8 এবং তারিখ ISO 8601 UTC ফরম্যাটে।

API কী কিভাবে তৈরি এবং পাঠানো হয়?

ড্যাশবোর্ডের API কী স্ক্রিনে কী তৈরি করুন। কী spx_ দিয়ে শুরু হয় এবং 44 অক্ষরের হয়, তৈরি করার সময় শুধু একবার দেখানো হয়। সার্ভারে কী এর হ্যাশ সংরক্ষিত থাকে, তাই হারিয়ে গেলে নতুন কী তৈরি করুন, নতুন কী তৈরি করলে আগের কী অবিলম্বে অকার্যকর হয়ে যায়।

প্রতিটি অনুরোধে অথোরাইজেশন হেডারে বেয়ার পদ্ধতিতে কী যুক্ত করুন। ঠিকানা ক্যোয়ারীতে কী যুক্ত করার পদ্ধতি গ্রহণ করা হয় না। কী না থাকলে বা ভুল হলে 401 আনঅথোরাইজড রেস্পন্স দেওয়া হবে।

curl -H "Authorization: Bearer spx_your_api_key" https://socks5proxy.io/api/v1/account

ব্যালেন্স এবং অ্যাকাউন্ট তথ্য চেক করুন: GET /account

অ্যাকাউন্ট কোড, ব্যালেন্স, সক্রিয় প্ল্যান ও প্রক্সি সংখ্যা রিটার্ন করে। ব্যালেন্স USD-তে দুই দশমিক স্থান পর্যন্ত দেখানো হয়।

curl -H "Authorization: Bearer spx_your_api_key" https://socks5proxy.io/api/v1/account

{
  "code": "S5-7KQ2-M8PX-4HDA",
  "balance": "125.40",
  "currency": "USD",
  "active_plans": 2,
  "proxies": 125,
  "created_at": "2026-10-22T08:15:02.114Z"
}

প্ল্যান লিস্ট দেখুন: GET /plans

কেনা প্ল্যানগুলি সাম্প্রতিক থেকে ফেরত দিন। status হয় active (ব্যবহারে), expired (মেয়াদ শেষ), canceled (বাতিল)। id হল প্ল্যান কোড (P- দিয়ে শুরু) এবং /proxies-এ plan মান হিসাবে ব্যবহার করা যেতে পারে।

{
  "plans": [
    {
      "id": "P-8WQ4C-NM2KT",
      "product": "dc-private",
      "product_name": "Private Datacenter Proxy",
      "ips": 100,
      "months": 1,
      "country": "us",
      "status": "active",
      "amount": "49.40",
      "created_at": "2026-10-22T08:20:11.002Z",
      "expires_at": "2026-11-22T08:20:11.002Z"
    }
  ]
}

প্রোক্সি তালিকা কোয়েরি: GET /proxies

আপনি যে প্ল্যানটি ব্যবহার করছেন তার প্রক্সিগুলি JSON আকারে ফেরত দেওয়া হবে। প্রতিটি প্রক্সিতে ঠিকানা, HTTP পোর্ট, SOCKS5 পোর্ট, ব্যবহারকারীর নাম, পাসওয়ার্ড, দেশ, শহর, প্ল্যান কোড এবং মেয়াদ শেষের সময় থাকবে।

country (দুই অক্ষরের দেশ কোড, যেমন: us) এবং plan (প্ল্যান কোড) দিয়ে ফিল্টার করা যায়। protocol মান রেসপন্সে সরাসরি দেখানো হয়, এবং JSON এ দুটি পোর্টই থাকে।

curl -H "Authorization: Bearer spx_your_api_key" \
  "https://socks5proxy.io/api/v1/proxies?country=us&protocol=socks5"

{
  "count": 1,
  "protocol": "socks5",
  "proxies": [
    {
      "host": "198.51.100.23",
      "http_port": 8231,
      "socks5_port": 1080,
      "username": "spx_k2m8qa",
      "password": "q7rbx2wd9n",
      "country": "us",
      "city": "New York",
      "plan": "P-8WQ4C-NM2KT",
      "product": "dc-private",
      "product_name": "Private Datacenter Proxy",
      "expires_at": "2026-11-22T08:20:11.002Z"
    }
  ]
}

তালিকা ডাউনলোড করুন: GET /proxies/download

প্রোগ্রাম সরাসরি পড়তে পারে এমনভাবে প্রতি লাইনে একটি প্রোক্সি টেক্সট ফরম্যাটে দেয়া হয়। protocol যদি socks5 হয় তবে SOCKS5 পোর্ট, http হলে HTTP পোর্ট যুক্ত করা হয়। format=url হলে protocol অনুযায়ী অ্যাড্রেস প্রিফিক্স (socks5:// বা http://) যুক্ত করা হয়।

IP অথোরাইজেশন চালু থাকা সার্ভারে ip:port ফরম্যাটে গ্রহণ করে ইউজারনেম ছাড়াই সরাসরি কানেক্ট করা যায়। csv-তে প্রথম লাইনে কলাম নাম থাকে এবং দুই পোর্টই অন্তর্ভুক্ত থাকে।

curl -H "Authorization: Bearer spx_your_api_key" \
  "https://socks5proxy.io/api/v1/proxies/download?format=url&protocol=socks5" -o proxies.txt

কোড উদাহরণ: Python, Node.js, PHP

নিচের উদাহরণটি লিস্ট পেয়ে প্রথম প্রক্সিতে অনুরোধ পাঠায়। Python-এ SOCKS5 ব্যবহার করতে requests[socks] প্যাকেজ প্রয়োজন, এবং socks5h ব্যবহার করলে ডোমেইন নাম রেজোলিউশনও প্রক্সি দিক থেকে করা হয়।

import requests

API = "https://socks5proxy.io/api/v1"
H = {"Authorization": "Bearer spx_your_api_key"}

proxies = requests.get(f"{API}/proxies", headers=H, params={"country": "us"}).json()["proxies"]
p = proxies[0]
url = f"socks5h://{p['username']}:{p['password']}@{p['host']}:{p['socks5_port']}"
r = requests.get("https://api.ipify.org?format=json", proxies={"http": url, "https": url}, timeout=30)
print(r.json())

import { ProxyAgent, fetch } from "undici";

const API = "https://socks5proxy.io/api/v1";
const H = { Authorization: "Bearer spx_your_api_key" };

const { proxies } = await (await fetch(`${API}/proxies?country=us`, { headers: H })).json();
const p = proxies[0];
const agent = new ProxyAgent(`http://${p.username}:${p.password}@${p.host}:${p.http_port}`);
const r = await fetch("https://api.ipify.org?format=json", { dispatcher: agent });
console.log(await r.json());

<?php
$ch = curl_init("https://socks5proxy.io/api/v1/proxies/download?format=ip:port:user:pass&protocol=http");
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => ["Authorization: Bearer spx_your_api_key"],
  CURLOPT_RETURNTRANSFER => true,
]);
$lines = explode("\n", trim(curl_exec($ch)));
[$host, $port, $user, $pass] = explode(":", $lines[0]);
echo "$host:$port\n";

এরর কোড ও কল লিমিট

এরর HTTP স্ট্যাটাস কোডসহ { "error": { "code", "message" } } ফরম্যাটে রিটার্ন হয়। প্রতি কী প্রতি মিনিটে ৩০০ কল লিমিট, অতিক্রম করলে ১ মিনিট ৪২৯ রেসপন্স। লিস্ট শুধু ক্রয়/এক্সপায়ারিতে পরিবর্তিত হয়, তাই কয়েক মিনিট পর পর নিয়ে প্রোগ্রামে রিইউজ করুন।

API কলের জন্য কোনো চার্জ নেই। ব্যালেন্স থেকে শুধু ড্যাশবোর্ডে প্ল্যান কেনার সময় খরচ হয়।