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 | প্রক্সি তৈরি করার জন্য পর্যাপ্ত ব্যান্ডউইথ ব্যালেন্স নেই |
| 403 | API 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 দিলে প্রতিটি অপশনে এখন কতটা খালি আছে তা যোগ হয়।
1tierstringঐচ্ছিককোন প্ল্যানের স্টক দেখাবে।
economybasicturboডিফল্ট:basicmodemsstringঐচ্ছিকstate-এর সাথে 1 দিলে সেখানকার সব মডেম (খালি ও ব্যস্ত) এবং প্রতিটি কতক্ষণ IP ধরে রাখে তা দেখায়। ফিল্ড /mobile/proxies/PROXY_ID/modems-এর মতোই।
1carrierintegerঐচ্ছিকক্যারিয়ার id। modems=1-এর সাথে দিলে শুধু সেই ক্যারিয়ারের মডেম দেখায়।
curl "https://socksnode.com/api/v1/mobile/catalog?state=12&availability=1" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"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"{
"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"{
"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ডিফল্ট:basicdurationKeystringপ্রয়োজনীয়ভাড়ার মেয়াদ। প্ল্যানটি যে মেয়াদ বিক্রি করে তা হতে হবে।
2h12h1d3d7d15d30dquantityintegerঐচ্ছিককয়টি পোর্ট ভাড়া নেবেন, 1–50। যেগুলো তৈরি হয় না সেগুলোর দাম কাটা হয় না।
ডিফল্ট:
1countryIdintegerঐচ্ছিকক্যাটালগের দেশ 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"
}'{
"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"
}'{
"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"{
"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"{
"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}API key লাগবে না
GET/mobile/proxies/{id}/rotate?token=…
আপনার ড্যাশবোর্ড থেকে একটিমাত্র কপি-পেস্ট লিংক। এটি খুলুন (browser, curl, একটি cron job, একটি bookmark) ঘুরাতে; দেশ/রাজ্য/ক্যারিয়ার বদলাতে location params যোগ করুন।
কোয়েরি প্যারামিটার
tokenstringপ্রয়োজনীয়পোর্টের রোটেশন টোকেন, ড্যাশবোর্ডে পোর্টের কার্ড থেকে। API কী লাগে না।
countryIdintegerঐচ্ছিকঐচ্ছিক। শুধু IP না বদলে এই লোকেশনে সরে যায়।
cityIdintegerঐচ্ছিকক্যাটালগের স্টেট id।
spIdintegerঐচ্ছিকক্যাটালগের ক্যারিয়ার id।
formatstringঐচ্ছিকরেসপন্সের ফরম্যাট।
jsonhtmlডিফল্ট:json
curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/rotate?token=YOUR_ROTATE_TOKEN"{
"ok": true,
"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"{
"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"
}'{
"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-গুলোকে পাসওয়ার্ড ছাড়া সংযোগ দেয়।
userpasswhitelistallowedIpsstring[]ঐচ্ছিকসর্বোচ্চ 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"
]
}'{
"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"
}'{
"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 তৈরি করুন।