SocksNode
ডেভেলপার

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প্রক্সি তৈরি করার জন্য পর্যাপ্ত ব্যান্ডউইথ ব্যালেন্স নেই
403API 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"
প্রতিক্রিয়া200
{
  "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_ipv4ipv6isp

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

    ক্যাটালগের দুই-অক্ষরের দেশ কোড।

  • 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"
প্রতিক্রিয়া200
{
  "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_ipv4ipv6isp

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

    ক্যাটালগের দুই-অক্ষরের দেশ কোড।

  • 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
  }'
প্রতিক্রিয়া201
{
  "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"
প্রতিক্রিয়া200
{
  "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"
প্রতিক্রিয়া200
{
  "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
  }'
প্রতিক্রিয়া201
{
  "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
  }'
প্রতিক্রিয়া200
{
  "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"
প্রতিক্রিয়া200
{
  "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।

    statecityasnisp

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

    দুই অক্ষরের দেশ কোড, যেমন 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"
প্রতিক্রিয়া200
{
  "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"
প্রতিক্রিয়া200
{
  "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"
    ]
  }'
প্রতিক্রিয়া201
{
  "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"
প্রতিক্রিয়া200
{
  "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
  }'
প্রতিক্রিয়া200
{
  "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"
প্রতিক্রিয়া200
{
  "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"
    ]
  }'
প্রতিক্রিয়া200
{
  "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"
    ]
  }'
প্রতিক্রিয়া200
{
  "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"
    ]
  }'
প্রতিক্রিয়া200
{
  "data": [{ "id": "cmv…", "ip": "73.12.148.20", "online": true, "speedMs": 1840 }]
}

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

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