API ও ইন্টিগ্রেশন ডকুমেন্টেশন
SocksNode ইন্টিগ্রেট করার দুটি উপায়: HTTP(S) বা SOCKS5 দিয়ে সরাসরি প্রক্সি গেটওয়ের সাথে সংযোগ করুন, অথবা REST API-এর মাধ্যমে ব্যান্ডউইথ, ব্যবহার ও প্রক্সি প্রোগ্রামেটিকভাবে পরিচালনা করুন।
এই পৃষ্ঠায়
স্ট্যাটিক IP ও IP Vault
সংক্ষেপ
স্ট্যাটিক ডেটাসেন্টার IP ও রেসিডেনশিয়াল ISP IP কিনুন, দেখুন ও রিনিউ করুন; IP Vault ঠিকানা ও ব্যান্ডউইথ কিনুন ও পরিচালনা করুন — ড্যাশবোর্ডের একই কাজ, আপনার কোড থেকে।
যে কল টাকা খরচ করে (কেনা ও রিনিউ) তার জন্য purchase অনুমতিসহ API কী লাগে এবং শুধু ওয়ালেট ব্যালান্স থেকে পেমেন্ট হয় — আগে টপ-আপ করুন। ব্যালান্স কম হলে 402 আসে এবং কিছু অর্ডার হয় না। স্ট্যাটিক অর্ডার ব্যাকগ্রাউন্ডে ডেলিভারি হয়: ডেলিভারি শেষ না হওয়া পর্যন্ত অর্ডার চেক করুন।
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 হেডার দেখুন |
| 503 | পণ্যটি রক্ষণাবেক্ষণে আছে। একটু পরে আবার চেষ্টা করুন। |
HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"error": {
"code": "no_bandwidth",
"message": "…"
}
}স্ট্যাটিক ডেটাসেন্টার ও ISP IP
স্ট্যাটিক IP ক্যাটালগ
GET/static/catalog
স্কোপ: read:proxies
কোয়েরি প্যারামিটার
typestringপ্রয়োজনীয়dedicated_ipv4, shared_ipv4 ও ipv6 হলো ডেটাসেন্টার IP; isp হলো রেসিডেনশিয়াল ISP IP।
dedicated_ipv4shared_ipv4ipv6isp
curl "https://socksnode.com/api/v1/static/catalog?type=dedicated_ipv4" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"type": "dedicated_ipv4",
"periodsDays": [5, 10, 20, 30, 60, 90, 120, 150, 180, 210, 240, 270, 300, 330, 360],
"maxQuantity": 100,
"countries": [
{ "code": "us", "name": "United States", "available": 1000, "cities": [{ "id": 3, "name": "New York", "available": 120 }] }
]
}স্ট্যাটিক অর্ডারের দাম
GET/static/quote
স্কোপ: read:proxies
কোয়েরি প্যারামিটার
typestringপ্রয়োজনীয়dedicated_ipv4, shared_ipv4 ও ipv6 হলো ডেটাসেন্টার IP; isp হলো রেসিডেনশিয়াল ISP IP।
dedicated_ipv4shared_ipv4ipv6ispcountrystringপ্রয়োজনীয়ক্যাটালগের দুই-অক্ষরের দেশ কোড।
quantityintegerপ্রয়োজনীয়কতগুলো IP (১–১০০)।
periodDaysintegerপ্রয়োজনীয়ভাড়ার দিন — এই ধরনের জন্য ক্যাটালগে থাকা মেয়াদগুলোর একটি।
curl "https://socksnode.com/api/v1/static/quote?type=isp&country=us&quantity=5&periodDays=30" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"type": "isp",
"country": "us",
"quantity": 5,
"periodDays": 30,
"unitPriceUsd": 3.4,
"totalUsd": 17
}স্ট্যাটিক IP কিনুন
POST/static/orders
স্কোপ: purchase
বডি প্যারামিটার
typestringপ্রয়োজনীয়dedicated_ipv4, shared_ipv4 ও ipv6 হলো ডেটাসেন্টার IP; isp হলো রেসিডেনশিয়াল ISP IP।
dedicated_ipv4shared_ipv4ipv6ispcountrystringপ্রয়োজনীয়ক্যাটালগের দুই-অক্ষরের দেশ কোড।
cityIdintegerঐচ্ছিকক্যাটালগের শহর id (শুধু ডেটাসেন্টার)। না দিলে যেকোনো শহর।
quantityintegerপ্রয়োজনীয়কতগুলো IP (১–১০০)।
periodDaysintegerপ্রয়োজনীয়ভাড়ার দিন — এই ধরনের জন্য ক্যাটালগে থাকা মেয়াদগুলোর একটি।
couponCodestringঐচ্ছিকডিসকাউন্ট কোড, যদি থাকে।
curl -X POST "https://socksnode.com/api/v1/static/orders" \
-H "Authorization: Bearer sk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "dedicated_ipv4",
"country": "us",
"quantity": 2,
"periodDays": 30
}'{
"id": "clx…",
"orderNumber": "SN-…",
"status": "paid",
"type": "dedicated_ipv4",
"country": "us",
"quantity": 2,
"periodDays": 30,
"amountUsd": 4.6,
"delivery": "pending"
}স্ট্যাটিক অর্ডারের অবস্থা
GET/static/orders/{id}
স্কোপ: read:proxies
পাথ প্যারামিটার
idstringপ্রয়োজনীয়অর্ডার করার সময় ফেরত আসা id।
curl "https://socksnode.com/api/v1/static/orders/ORDER_ID" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"id": "clx…",
"status": "paid",
"delivery": "done",
"delivered": 2,
"quantity": 2,
"refundedUsd": 0,
"ips": [ … ]
}আপনার স্ট্যাটিক IP
GET/static
স্কোপ: read:proxies
কোয়েরি প্যারামিটার
typestringঐচ্ছিককোন স্ট্যাটিক IP দেখাবেন।
alldatacenterispডিফল্ট:all
curl "https://socksnode.com/api/v1/static" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"data": [
{
"id": "clx…",
"ip": "203.0.113.25",
"host": "203.0.113.25",
"portHttp": 50100,
"portSocks5": 50101,
"username": "u3k2…",
"password": "…",
"type": "dedicated_ipv4",
"countryCode": "us",
"status": "active",
"expiresAt": "2026-11-03T10:00:00.000Z",
"daysLeft": 30,
"autoRenew": false
}
]
}স্ট্যাটিক IP রিনিউ
POST/static/renew
স্কোপ: purchase
বডি প্যারামিটার
idsstring[]প্রয়োজনীয়রিনিউ করার IP-এর id — ডেটাসেন্টার ও ISP আলাদা কলে।
periodDaysintegerপ্রয়োজনীয়ভাড়ার দিন — এই ধরনের জন্য ক্যাটালগে থাকা মেয়াদগুলোর একটি।
curl -X POST "https://socksnode.com/api/v1/static/renew" \
-H "Authorization: Bearer sk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"STATIC_ID"
],
"periodDays": 30
}'{
"jobId": "clx…",
"renewed": 1,
"chargedUsd": 2.3,
"delivery": "pending"
}স্ট্যাটিক IP আপডেট
PATCH/static/{id}
স্কোপ: write:proxies
পাথ প্যারামিটার
idstringপ্রয়োজনীয়স্ট্যাটিক IP-এর id।
বডি প্যারামিটার
autoRenewbooleanঐচ্ছিকমেয়াদ শেষের আগে ওয়ালেট থেকে স্বয়ংক্রিয় রিনিউ।
namestringঐচ্ছিকIP-এর নাম।
notestringঐচ্ছিকব্যক্তিগত নোট।
curl -X PATCH "https://socksnode.com/api/v1/static/STATIC_ID" \
-H "Authorization: Bearer sk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"autoRenew": true
}'{
"id": "clx…",
"autoRenew": true,
…
}২৪ ঘণ্টার ডেডিকেটেড রেসিডেনশিয়াল IP
২৪ ঘণ্টার রেসিডেনশিয়াল IP (/day-ip): দেশ, রাজ্য, শহর বা ISP অনুযায়ী বিক্রির ঠিকানা দেখুন, ref দিয়ে নির্দিষ্ট ঠিকানা বা সংখ্যা দিয়ে যেকোনো মিলে যাওয়া ঠিকানা কিনুন, তারপর আপনার ঠিকানাগুলোর তালিকা, নোট, প্রিয়, ফ্রড চেক ও গতি পরীক্ষা করুন। প্রতিটি ঠিকানা সর্বোচ্চ ২৪ ঘণ্টা, GB সীমা ছাড়া চলে; কেনার ১০ মিনিটের মধ্যে কাজ না করলে টাকা ফেরত পাওয়া যায়।
২৪ ঘণ্টার IP: দেশ ও দাম
GET/day-ip/countries
স্কোপ: read:proxies
কোয়েরি প্যারামিটার
poolstringঐচ্ছিককোন নেটওয়ার্কের তালিকা: a (ডিফল্ট) বা b। দুটি নেটওয়ার্ক আলাদা দেশ কাভার করে, তাই প্রতিটি নিজের তালিকা দেয়।
abডিফল্ট:a
curl "https://socksnode.com/api/v1/day-ip/countries" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"priceUsd": 0.09,
"count": 219,
"data": [{ "code": "US", "name": "United States" }]
}২৪ ঘণ্টার IP: রাজ্য, শহর ও ISP
GET/day-ip/places
স্কোপ: read:proxies
কোয়েরি প্যারামিটার
levelstringপ্রয়োজনীয়কী তালিকা হবে: state (রাজ্য), city (শহর) বা asn (ISP নেটওয়ার্ক); নেটওয়ার্ক b-তে asn-এর বদলে isp।
statecityasnispcountrystringপ্রয়োজনীয়দুই অক্ষরের দেশ কোড, যেমন US।
statestringঐচ্ছিকরাজ্য বা অঞ্চল, /day-ip/places যেভাবে দেয়।
poolstringঐচ্ছিককোন নেটওয়ার্কের তালিকা: a (ডিফল্ট) বা b। দুটি নেটওয়ার্ক আলাদা দেশ কাভার করে, তাই প্রতিটি নিজের তালিকা দেয়।
abডিফল্ট:a
curl "https://socksnode.com/api/v1/day-ip/places?level=city&country=US&state=Texas" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"level": "city",
"country": "US",
"data": [{ "value": "Dallas", "label": "Dallas" }]
}২৪ ঘণ্টার IP: বিক্রির ঠিকানা
GET/day-ip/shop
স্কোপ: read:proxies
কোয়েরি প্যারামিটার
countrystringপ্রয়োজনীয়দুই অক্ষরের দেশ কোড, যেমন US।
statestringঐচ্ছিকরাজ্য বা অঞ্চল, /day-ip/places যেভাবে দেয়।
citystringঐচ্ছিকশহর, /day-ip/places যেভাবে দেয়; রাজ্য লাগে না।
asnintegerঐচ্ছিকISP নেটওয়ার্ক নম্বর, যেমন 7922।
freshbooleanঐচ্ছিকtrue দিলে শেষ ৯০ সেকেন্ডের কপির বদলে নতুন করে তালিকা আনে।
morebooleanঐচ্ছিকtrue দিলে তালিকায় নতুন একটি ব্যাচ যোগ হয় (সর্বোচ্চ ৫০০)। প্রতিবার সর্বোচ্চ ১০০টি ঠিকানা আসে এবং IP রেঞ্জ দিয়ে খোঁজা যায় না, তাই তালিকা বাড়িয়ে খুঁজুন।
ispstringঐচ্ছিকনামে নেটওয়ার্ক, ঠিক যেমন /day-ip/places দেখায় (নেটওয়ার্ক b)।
zipstringঐচ্ছিকZIP কোড, হুবহু মিল (নেটওয়ার্ক b)।
poolstringঐচ্ছিককোন নেটওয়ার্ক: a (ডিফল্ট) বা b। নেটওয়ার্ক b-তে country বাধ্যতামূলক, asn-এর বদলে isp ও zip দিয়ে ছাঁকা হয়, এবং প্রতিটি ঠিকানার সঙ্গে একটি ping থাকে; fresh ও more এতে কাজ করে না।
abডিফল্ট:a
curl "https://socksnode.com/api/v1/day-ip/shop?country=US&state=Texas" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"priceUsd": 0.09,
"walletUsd": 12.4,
"count": 98,
"data": [
{ "ref": "DO7fs76WkECuwM", "ip": "73.12.148.*", "cc": "US", "state": "Texas", "city": "Dallas", "isp": "Comcast Cable Communications, LLC", "asn": 7922 }
]
}২৪ ঘণ্টার IP: কিনুন
POST/day-ip/ips
স্কোপ: purchase
বডি প্যারামিটার
refsstring[]ঐচ্ছিকনির্দিষ্ট ঠিকানা কিনতে: /day-ip/shop থেকে প্রতিটির ref। একটি ref প্রায় ৫ মিনিট কেনা যায়। সর্বোচ্চ ৫০।
countrystringঐচ্ছিকrefs-এর বদলে: এই দেশে মিলে যাওয়া যেকোনো ঠিকানা কিনুন (state, city বা asn দিয়ে সংকুচিত করুন)।
statestringঐচ্ছিকরাজ্য বা অঞ্চল, /day-ip/places যেভাবে দেয়।
citystringঐচ্ছিকশহর, /day-ip/places যেভাবে দেয়; রাজ্য লাগে না।
asnintegerঐচ্ছিকISP নেটওয়ার্ক নম্বর, যেমন 7922।
countintegerঐচ্ছিকcountry-র সাথে: কতগুলো ঠিকানা, ১–৫০।
ispstringঐচ্ছিকনামে নেটওয়ার্ক, ঠিক যেমন /day-ip/places দেখায় (নেটওয়ার্ক b)।
poolstringঐচ্ছিককোন নেটওয়ার্ক: a (ডিফল্ট) বা b। নেটওয়ার্ক b শুধু নির্দিষ্ট ঠিকানা বিক্রি করে — count নয়, refs ও country পাঠান।
abডিফল্ট:a
curl -X POST "https://socksnode.com/api/v1/day-ip/ips" \
-H "Authorization: Bearer sk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"refs": [
"SHOP_REF_1",
"SHOP_REF_2"
]
}'{
"bought": [
{ "id": "cmv…", "proxy": "vault.socksnode.com:27311:user-ip:pass", "ip": "73.12.148.20", "country": "US", "city": "Dallas", "isp": "Comcast Cable Communications, LLC", "asn": 7922, "expiresAt": "2026-10-12T15:36:40Z" }
],
"chargedUsd": 0.18,
"refundedUsd": 0
}২৪ ঘণ্টার IP: আপনার তালিকা
GET/day-ip/ips
স্কোপ: read:proxies
কোয়েরি প্যারামিটার
viewstringঐচ্ছিকactive: ২৪ ঘণ্টার মধ্যে থাকা ঠিকানা; all: গত ৭ দিনেরগুলোও।
activeallডিফল্ট:active
curl "https://socksnode.com/api/v1/day-ip/ips" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"view": "active",
"count": 1,
"data": [
{ "id": "cmv…", "proxy": "vault.socksnode.com:27311:user-ip:pass", "ip": "73.12.148.20", "country": "US", "status": "active", "expiresAt": "2026-10-12T15:36:40Z", "fraud": { "score": 12, "risk": "low", "listed": false }, "speedMs": 1840, "note": "shop #3", "favorite": true }
]
}২৪ ঘণ্টার IP: নোট ও প্রিয়
PATCH/day-ip/ips/{id}
স্কোপ: write:proxies
পাথ প্যারামিটার
idstringপ্রয়োজনীয়আপনার একটি ২৪ ঘণ্টার IP-এর id।
বডি প্যারামিটার
notestringঐচ্ছিকঠিকানার জন্য আপনার নোট, সর্বোচ্চ ২০০ অক্ষর।
favoritebooleanঐচ্ছিকপ্রিয়তে যোগ বা সরানো।
curl -X PATCH "https://socksnode.com/api/v1/day-ip/ips/DAY_IP_ID" \
-H "Authorization: Bearer sk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"note": "shop #3",
"favorite": true
}'{
"id": "cmv…",
"ok": true
}২৪ ঘণ্টার IP: নষ্ট IP-এর টাকা ফেরত
POST/day-ip/ips/{id}/refund
স্কোপ: write:proxies
পাথ প্যারামিটার
idstringপ্রয়োজনীয়আপনার একটি ২৪ ঘণ্টার IP-এর id।
curl -X POST "https://socksnode.com/api/v1/day-ip/ips/DAY_IP_ID/refund" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"id": "cmv…",
"result": "refunded",
"windowMinutes": 10
}২৪ ঘণ্টার IP: একসঙ্গে কয়েকটি নষ্ট IP-এর টাকা ফেরত
POST/day-ip/ips/refund
স্কোপ: write:proxies
বডি প্যারামিটার
idsstring[]প্রয়োজনীয়যে ২৪ ঘণ্টার IP-এর টাকা ফেরত চান তার id, সর্বোচ্ব ৫০। প্রতিটি আগে আবার পরেখা করা হয়, এবং উত্তরে প্রতিটি id-এর ফল থাকে: refunded, still_online বা expired।
curl -X POST "https://socksnode.com/api/v1/day-ip/ips/refund" \
-H "Authorization: Bearer sk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"DAY_IP_ID_1",
"DAY_IP_ID_2"
]
}'{
"refunded": 1,
"stillOnline": 1,
"expired": 0,
"windowMinutes": 10,
"data": [
{ "id": "cmv…", "result": "refunded", "why": "dead", "usd": 0.09 },
{ "id": "cmw…", "result": "still_online", "usd": 0 }
]
}২৪ ঘণ্টার IP: ফ্রড চেক
POST/day-ip/ips/fraud
স্কোপ: purchase
বডি প্যারামিটার
idsstring[]প্রয়োজনীয়আপনার ২৪ ঘণ্টার IP-এর id, সর্বোচ্চ ৫০। প্রতিটি $0.003 ব্যালান্স থেকে।
curl -X POST "https://socksnode.com/api/v1/day-ip/ips/fraud" \
-H "Authorization: Bearer sk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"DAY_IP_ID"
]
}'{
"checked": 1,
"failed": 0,
"chargedUsd": 0.003,
"data": [{ "id": "cmv…", "ip": "73.12.148.20", "fraud": { "score": 12, "risk": "low", "listed": false } }]
}২৪ ঘণ্টার IP: লাইভ যাচাই (অনলাইন / অফলাইন)
POST/day-ip/ips/speed
স্কোপ: read:proxies
বডি প্যারামিটার
idsstring[]প্রয়োজনীয়আপনার ২৪ ঘণ্টার IP-এর id, সর্বোচ্চ ২০।
curl -X POST "https://socksnode.com/api/v1/day-ip/ips/speed" \
-H "Authorization: Bearer sk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"DAY_IP_ID"
]
}'{
"data": [{ "id": "cmv…", "ip": "73.12.148.20", "online": true, "speedMs": 1840 }]
}তৈরি করতে প্রস্তুত?
ড্যাশবোর্ডে ক্রেডেনশিয়াল তৈরি করুন অথবা এটি স্বয়ংক্রিয় করতে একটি API key তৈরি করুন।