SocksNode
ডেভেলপার

API ও ইন্টিগ্রেশন ডকুমেন্টেশন

SocksNode ইন্টিগ্রেট করার দুটি উপায়: HTTP(S) বা SOCKS5 দিয়ে সরাসরি প্রক্সি গেটওয়ের সাথে সংযোগ করুন, অথবা REST API-এর মাধ্যমে ব্যান্ডউইথ, ব্যবহার ও প্রক্সি প্রোগ্রামেটিকভাবে পরিচালনা করুন।

এই পৃষ্ঠায়

মোবাইল প্রক্সি

4G/5G REST API

4G/5G মোবাইল প্রক্সি প্রোগ্রামেটিকভাবে কিনুন এবং পরিচালনা করুন। প্রতিটি Mobile IP হলো একটি ঘূর্ণায়মান ক্যারিয়ার IP (সর্বোচ্চ 3টি কানেকশন) নির্দিষ্ট সময়ের জন্য। ভাড়া ও নবায়নের খরচ আপনার প্রিপেইড অ্যাকাউন্ট ক্রেডিট (USD) থেকে কাটা হয়। read:proxies / write:proxies স্কোপ ব্যবহার করে।

https://socksnode.com/api/v1

প্রমাণীকরণ

Base URL https://socksnode.com/api/v1. Dashboard → API access-এ একটি key তৈরি করুন এবং এটি Bearer token হিসেবে পাঠান। Keys scoped — কেবল আপনার যা প্রয়োজন তা-ই request করুন।

স্কোপঅনুমতিসমূহ
read:usageব্যালেন্স ও ব্যবহার বিশ্লেষণ
read:proxiesসংরক্ষিত প্রক্সি ক্রেডেনশিয়াল তালিকা
write:proxiesনতুন প্রক্সি ক্রেডেনশিয়াল তৈরি করুন
purchaseরোটেটিং রেসিডেনশিয়াল, ডেটাসেন্টার ও মোবাইল প্রক্সির জন্য GB কেনা, স্ট্যাটিক ও ISP IP কেনা ও নবায়ন, 4G/5G পোর্ট ভাড়া ও নবায়ন, অটো-রিনিউ চালু করা, 24 ঘণ্টার IP এবং IP Vault-এর ঠিকানা ও ব্যান্ডউইথ কেনা — আপনার ব্যালান্স থেকে কাটা হয়।

রেট সীমা: প্রতি কী প্রতি মিনিটে 120 অনুরোধ (প্রক্সি তৈরি আরও সীমিত থাকে)। আপনার কী গোপন রাখুন এবং সার্ভার-সাইডে রাখুন.

GET /api/v1/account HTTP/1.1
Host: socksnode.com
Authorization: Bearer sk_YOUR_API_KEY

ত্রুটি

ত্রুটিগুলো মিল থাকা HTTP স্ট্যাটাসসহ { "error": { "code", "message" } } একটি JSON বডি ফেরত দেয়:

স্ট্যাটাসঅর্থ
400অবৈধ অনুরোধ বডি বা প্যারামিটার
401অনুপস্থিত, অবৈধ বা প্রত্যাহারকৃত API key
402প্রক্সি তৈরি করার জন্য পর্যাপ্ত ব্যান্ডউইথ ব্যালেন্স নেই
403API key-এ প্রয়োজনীয় স্কোপ অনুপস্থিত
404পাওয়া যায়নি, বা আপনার নয়।
409পোর্টের অবস্থা এখন এটি করতে দেয় না, যেমন মেয়াদ শেষ।
429রেট সীমা অতিক্রম হয়েছে — Retry-After হেডার দেখুন
502আপস্ট্রিম নেটওয়ার্কে ত্রুটি। আপনার টাকা কাটা হয়নি।
503পণ্যটি রক্ষণাবেক্ষণে আছে। একটু পরে আবার চেষ্টা করুন।
HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "error": {
    "code": "no_bandwidth",
    "message": "…"
  }
}

API এন্ডপয়েন্ট

মেয়াদ, দেশ, রাজ্য ও ক্যারিয়ার

GET/mobile/catalog

স্কোপ: read:proxies

কোয়েরি প্যারামিটার

  • countryintegerঐচ্ছিক

    দেশ id। এর স্টেটগুলো ফেরত দেয়।

  • stateintegerঐচ্ছিক

    স্টেট id। এর ক্যারিয়ারগুলো ফেরত দেয়।

  • availabilitystringঐচ্ছিক

    1 দিলে প্রতিটি অপশনে এখন কতটা খালি আছে তা যোগ হয়।

    1

  • tierstringঐচ্ছিক

    কোন প্ল্যানের স্টক দেখাবে।

    economybasicturboডিফল্ট: basic

  • modemsstringঐচ্ছিক

    state-এর সাথে 1 দিলে সেখানকার সব মডেম (খালি ও ব্যস্ত) এবং প্রতিটি কতক্ষণ IP ধরে রাখে তা দেখায়। ফিল্ড /mobile/proxies/PROXY_ID/modems-এর মতোই।

    1

  • carrierintegerঐচ্ছিক

    ক্যারিয়ার id। modems=1-এর সাথে দিলে শুধু সেই ক্যারিয়ারের মডেম দেখায়।

curl "https://socksnode.com/api/v1/mobile/catalog?state=12&availability=1" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
প্রতিক্রিয়া200
{
  "data": {
    "carriers": [
      { "id": 34, "name": "5G AT&T", "status": "ok", "pct": 82 },
      { "id": 35, "name": "5G T-Mobile", "status": "low", "pct": 11 },
      { "id": 36, "name": "5G Verizon", "status": "none", "pct": 0 }
    ]
  }
}
// status: "ok" | "low" | "none" | "unknown"
// Country and state stock is refreshed every ~15 min;
// carrier stock is checked live, right before you choose.

আপনার মোবাইল প্রক্সি তালিকাভুক্ত করুন (ক্রেডেনশিয়ালসহ)

GET/mobile/proxies

স্কোপ: read:proxies

কোনো প্যারামিটার নেই।

curl "https://socksnode.com/api/v1/mobile/proxies" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
প্রতিক্রিয়া200
{
  "data": [
    {
      "id": "clx…",
      "name": "Port 1",
      "host": "mobile.socksnode.com",
      "port": 9094,
      "protocol": "socks5",
      "username": "sn_a1b2c3d4",
      "password": "…",
      "authMode": "userpass",
      "allowedIps": [],
      "country": "UNITED STATES",
      "state": "FLORIDA",
      "carrier": "5G AT&T",
      "rotationMinutes": 15,
      "modem": { "id": "3f9c0a1b2d4e5f607182", "code": "K7QM" },
      "status": "active",
      "paused": false,
      "bytesUsed": 0,
      "lastExitIp": null,
      "expiresAt": "2026-10-30T04:46:53.000Z"
    }
  ]
}

একটি প্রক্সি

GET/mobile/proxies/{id}

ব্যবহৃত ডেটা + শেষ এক্সিট IP অন্তর্ভুক্ত

স্কোপ: read:proxies

পাথ প্যারামিটার

  • idstringপ্রয়োজনীয়

    মোবাইল প্রক্সির id।

curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
প্রতিক্রিয়া200
{
  "data": {
    "id": "clx…",
    "name": "Port 1",
    "host": "mobile.socksnode.com",
    "port": 9094,
    "protocol": "socks5",
    "username": "sn_a1b2c3d4",
    "password": "…",
    "authMode": "userpass",
    "allowedIps": [],
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "rotationMinutes": 15,
    "modem": { "id": "3f9c0a1b2d4e5f607182", "code": "K7QM" },
    "status": "active",
    "paused": false,
    "bytesUsed": 0,
    "lastExitIp": null,
    "expiresAt": "2026-10-30T04:46:53.000Z"
  }
}

Nটি পোর্ট কিনুন (ক্রেডিট থেকে চার্জ হবে; খুব কম হলে 402)

POST/mobile/proxies

স্কোপ: purchase

বডি প্যারামিটার

  • tierKeystringঐচ্ছিক

    যে প্ল্যান ভাড়া নেবেন।

    economybasicturboডিফল্ট: basic

  • durationKeystringপ্রয়োজনীয়

    ভাড়ার মেয়াদ। প্ল্যানটি যে মেয়াদ বিক্রি করে তা হতে হবে।

    2h12h1d3d7d15d30d

  • quantityintegerঐচ্ছিক

    কয়টি পোর্ট ভাড়া নেবেন, 1–50। যেগুলো তৈরি হয় না সেগুলোর দাম কাটা হয় না।

    ডিফল্ট: 1

  • countryIdintegerঐচ্ছিক

    ক্যাটালগের দেশ id। না দিলে যেকোনো খালি লোকেশন।

  • cityIdintegerঐচ্ছিক

    ক্যাটালগের স্টেট id।

  • spIdintegerঐচ্ছিক

    ক্যাটালগের ক্যারিয়ার id।

  • modemIdstringঐচ্ছিক

    /mobile/catalog?modems=1 থেকে একটি মডেম id (একই প্ল্যান)। cityId ও quantity 1 লাগবে। খালি জায়গা না থাকলে 409 modem_taken; আপনার টাকা কাটা হবে না।

  • protocolstringঐচ্ছিক

    পোর্টের প্রোটোকল।

    sockshttpডিফল্ট: socks

curl -X POST "https://socksnode.com/api/v1/mobile/proxies" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "durationKey": "30d",
    "quantity": 1,
    "countryId": 1,
    "cityId": 12,
    "spId": 34,
    "protocol": "socks"
  }'
প্রতিক্রিয়া201
{
  "data": [
    {
      "id": "clx…",
      "name": "Port 1",
      "host": "mobile.socksnode.com",
      "port": 9094,
      "protocol": "socks5",
      "username": "sn_a1b2c3d4",
      "password": "…",
      "authMode": "userpass",
      "allowedIps": [],
      "country": "UNITED STATES",
      "state": "FLORIDA",
      "carrier": "5G AT&T",
      "rotationMinutes": 15,
      "modem": { "id": "3f9c0a1b2d4e5f607182", "code": "K7QM" },
      "status": "active",
      "paused": false,
      "bytesUsed": 0,
      "lastExitIp": null,
      "expiresAt": "2026-10-30T04:46:53.000Z"
    }
  ],
  "charged": 40
}

দেশ/রাজ্য/ক্যারিয়ার পরিবর্তন করুন (ফ্রি)

POST/mobile/proxies/{id}/switch

স্কোপ: write:proxies

পাথ প্যারামিটার

  • idstringপ্রয়োজনীয়

    মোবাইল প্রক্সির id।

বডি প্যারামিটার

  • countryIdintegerপ্রয়োজনীয়

    ক্যাটালগের দেশ id।

  • cityIdintegerঐচ্ছিক

    ক্যাটালগের স্টেট id।

  • spIdintegerঐচ্ছিক

    ক্যাটালগের ক্যারিয়ার id।

  • modemIdstringঐচ্ছিক

    মডেম তালিকা থেকে একটি মডেম id। cityId লাগবে। পোর্ট শুধু সেই মডেমেই যাবে: ভরা থাকলে 409 modem_taken, তালিকায় না থাকলে 404 modem_gone।

  • protocolstringঐচ্ছিক

    ডিফল্ট হলো পোর্টের বর্তমান প্রোটোকল।

    sockshttp

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/switch" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "countryId": 3,
    "cityId": 12,
    "spId": 34,
    "modemId": "8d21e7c40b9a6f5e3c12"
  }'
প্রতিক্রিয়া200
{
  "data": {
    "id": "clx…",
    "host": "mobile.socksnode.com",
    "port": 9095,
    "protocol": "socks5",
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "status": "active"
  }
}
// + every other field of GET /mobile/proxies/{id}

পোর্টের জন্য একটি স্টেটের মডেম তালিকা (খালি ও ব্যস্ত, IP ধরে রাখার সময়)

GET/mobile/proxies/{id}/modems

স্কোপ: read:proxies

পাথ প্যারামিটার

  • idstringপ্রয়োজনীয়

    মোবাইল প্রক্সির id।

কোয়েরি প্যারামিটার

  • stateintegerপ্রয়োজনীয়

    ক্যাটালগের স্টেট id। এই পোর্টের প্ল্যান অনুযায়ী সেই স্টেটের মডেম দেখায়।

  • carrierintegerঐচ্ছিক

    ক্যারিয়ার id। modems=1-এর সাথে দিলে শুধু সেই ক্যারিয়ারের মডেম দেখায়।

curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/modems?state=12&carrier=34" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
প্রতিক্রিয়া200
{
  "data": {
    "modems": [
      {
        "id": "3f9c0a1b2d4e5f607182",
        "code": "K7QM",
        "carrier": "5G AT&T",
        "free": true,
        "current": true,
        "yours": 0,
        "yourPorts": [],
        "rotationMinutes": 30,
        "lastIp": "174.208.161.27",
        "lastOkAt": "2026-10-28T03:12:40.000Z",
        "failing": false
      },
      {
        "id": "8d21e7c40b9a6f5e3c12",
        "code": "R4XB",
        "carrier": "5G AT&T",
        "free": false,
        "current": false,
        "yours": 0,
        "yourPorts": [],
        "rotationMinutes": 60,
        "lastIp": null,
        "lastOkAt": null,
        "failing": false
      }
    ],
    "free": 1,
    "total": 2
  }
}
// free: has a slot for one more port. current: this port is on it.
// yours: your other live ports on it (they share its IP); yourPorts: their port numbers.
// rotationMinutes: how long the modem keeps one IP.

নতুন এক্সিট IP (ফ্রি)

POST/mobile/proxies/{id}/rotate

স্কোপ: write:proxies

পাথ প্যারামিটার

  • idstringপ্রয়োজনীয়

    মোবাইল প্রক্সির id।

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/rotate" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
প্রতিক্রিয়া200
{
  "data": {
    "id": "clx…",
    "host": "mobile.socksnode.com",
    "port": 9095,
    "protocol": "socks5",
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "status": "active"
  }
}
// + every other field of GET /mobile/proxies/{id}

লাইভ এক্সিট IP দেখুন

GET/mobile/proxies/{id}/check-ip

স্কোপ: read:proxies

পাথ প্যারামিটার

  • idstringপ্রয়োজনীয়

    মোবাইল প্রক্সির id।

curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/check-ip" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
প্রতিক্রিয়া200
{
  "data": { "ip": "174.208.161.27" }
}

SOCKS5 ↔ HTTP(S) পরিবর্তন করুন

POST/mobile/proxies/{id}/protocol

স্কোপ: write:proxies

পাথ প্যারামিটার

  • idstringপ্রয়োজনীয়

    মোবাইল প্রক্সির id।

বডি প্যারামিটার

  • protocolstringপ্রয়োজনীয়

    পোর্টের প্রোটোকল।

    sockshttp

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/protocol" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "protocol": "http"
  }'
প্রতিক্রিয়া200
{
  "data": {
    "id": "clx…",
    "host": "mobile.socksnode.com",
    "port": 9095,
    "protocol": "socks5",
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "status": "active"
  }
}
// + every other field of GET /mobile/proxies/{id}

auth mode পরিবর্তন করুন

POST/mobile/proxies/{id}/auth

স্কোপ: write:proxies

পাথ প্যারামিটার

  • idstringপ্রয়োজনীয়

    মোবাইল প্রক্সির id।

বডি প্যারামিটার

  • modestringপ্রয়োজনীয়

    userpass ইউজারনেম ও পাসওয়ার্ড দিয়ে লগইন; whitelist তালিকার IP-গুলোকে পাসওয়ার্ড ছাড়া সংযোগ দেয়।

    userpasswhitelist

  • allowedIpsstring[]ঐচ্ছিক

    সর্বোচ্চ 3টি পাবলিক IPv4 বা IPv6 ঠিকানা, রেঞ্জ নয়। whitelist-এর জন্য দরকার।

    ডিফল্ট: []

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/auth" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "whitelist",
    "allowedIps": [
      "203.0.113.7"
    ]
  }'
প্রতিক্রিয়া200
{
  "data": {
    "id": "clx…",
    "host": "mobile.socksnode.com",
    "port": 9095,
    "protocol": "socks5",
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "status": "active"
  }
}
// + every other field of GET /mobile/proxies/{id}

পোর্ট বাড়ান (ক্রেডিট থেকে চার্জ হবে)

POST/mobile/proxies/{id}/renew

স্কোপ: purchase

পাথ প্যারামিটার

  • idstringপ্রয়োজনীয়

    মোবাইল প্রক্সির id।

বডি প্যারামিটার

  • durationKeystringপ্রয়োজনীয়

    ভাড়ার মেয়াদ। পোর্টের প্ল্যান যে মেয়াদ বিক্রি করে তা হতে হবে।

    2h12h1d3d7d15d30d

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/renew" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "durationKey": "30d"
  }'
প্রতিক্রিয়া200
{
  "data": {
    "id": "clx…",
    "host": "mobile.socksnode.com",
    "port": 9095,
    "protocol": "socks5",
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "status": "active"
  },
  "charged": 40
}
// + every other field of GET /mobile/proxies/{id}

তৈরি করতে প্রস্তুত?

ড্যাশবোর্ডে ক্রেডেনশিয়াল তৈরি করুন অথবা এটি স্বয়ংক্রিয় করতে একটি API key তৈরি করুন।