Nhà phát triển

Tài liệu API & tích hợp

Hai cách tích hợp SocksNode: kết nối trực tiếp tới proxy gateway qua HTTP(S) hoặc SOCKS5, hoặc quản lý băng thông, mức sử dụng và proxy bằng chương trình thông qua REST API.

Trong trang này

Proxy di động

REST API 4G/5G

Mua và quản lý proxy di động 4G/5G bằng API. Mỗi Mobile IP là một IP nhà mạng xoay vòng (tối đa 3 kết nối) trong thời hạn bạn chọn. Thuê và gia hạn được trừ vào số dư tài khoản trả trước (USD). Dùng scope read:proxies / write:proxies.

https://socksnode.com/api/v1

Xác thực

URL gốc https://socksnode.com/api/v1. Tạo key trong Dashboard → API access và gửi dưới dạng Bearer token. Key có phạm vi giới hạn — chỉ yêu cầu những gì bạn cần.

Phạm viCấp quyền
read:usageSố dư & phân tích mức sử dụng
read:proxiesLiệt kê thông tin đăng nhập proxy đã lưu
write:proxiesTạo thông tin đăng nhập proxy mới
purchaseMua GB cho proxy xoay vòng dân cư, datacenter và mobile, mua và gia hạn IP tĩnh và IP ISP, thuê và gia hạn port 4G/5G, bật tự gia hạn, mua IP 24 giờ, IP Vault và băng thông — trừ vào số dư ví.

Giới hạn tần suất: 120 request mỗi phút cho mỗi key (việc tạo proxy còn bị giới hạn chặt hơn). Giữ key bí mật và chỉ dùng phía máy chủ.

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

Lỗi

Lỗi trả về một body JSON { "error": { "code", "message" } } kèm mã trạng thái HTTP tương ứng:

Trạng tháiÝ nghĩa
400Body hoặc tham số request không hợp lệ
401API key thiếu, không hợp lệ hoặc đã bị thu hồi
402Số dư băng thông không đủ để tạo proxy
403API key thiếu phạm vi bắt buộc
404Không tìm thấy, hoặc không phải của bạn.
409Trạng thái cổng không cho phép lúc này, vd đã hết hạn.
429Vượt giới hạn tần suất — xem header Retry-After
502Mạng phía trên bị lỗi. Bạn không bị trừ tiền.
503Sản phẩm đang bảo trì. Thử lại sau ít phút.
HTTP/1.1 402 Payment Required
Content-Type: application/json

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

Endpoint API

thời hạn, quốc gia, bang & nhà mạng

GET/mobile/catalog

Phạm vi: read:proxies

Tham số query

  • countryintegerTùy chọn

    Id quốc gia. Trả về các bang.

  • stateintegerTùy chọn

    Id bang. Trả về các nhà mạng.

  • availabilitystringTùy chọn

    Đặt 1 để biết mỗi lựa chọn còn trống bao nhiêu ngay lúc này.

    1

  • tierstringTùy chọn

    Gói cần xem tồn kho.

    economybasicturboMặc định: basic

  • modemsstringTùy chọn

    Đặt 1 cùng với state để liệt kê mọi modem ở đó, cả rảnh lẫn bận, kèm thời gian mỗi modem giữ IP. Cùng các trường với /mobile/proxies/PROXY_ID/modems.

    1

  • carrierintegerTùy chọn

    Id nhà mạng. Với modems=1, chỉ liệt kê modem của nhà mạng đó.

curl "https://socksnode.com/api/v1/mobile/catalog?state=12&availability=1" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Phản hồi200
{
  "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.

liệt kê proxy di động của bạn (kèm thông tin đăng nhập)

GET/mobile/proxies

Phạm vi: read:proxies

Không có tham số.

curl "https://socksnode.com/api/v1/mobile/proxies" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Phản hồi200
{
  "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"
    }
  ]
}

một proxy

GET/mobile/proxies/{id}

kèm data đã dùng + IP thoát gần nhất

Phạm vi: read:proxies

Tham số đường dẫn

  • idstringBắt buộc

    Id của proxy di động.

curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Phản hồi200
{
  "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"
  }
}

mua N cổng (trừ vào số dư; 402 nếu không đủ)

POST/mobile/proxies

Phạm vi: purchase

Tham số body

  • tierKeystringTùy chọn

    Gói cần thuê.

    economybasicturboMặc định: basic

  • durationKeystringBắt buộc

    Thời hạn thuê. Phải là thời hạn gói đó có bán.

    2h12h1d3d7d15d30d

  • quantityintegerTùy chọn

    Số cổng cần thuê, 1–50. Cổng nào không tạo được thì không bị tính tiền.

    Mặc định: 1

  • countryIdintegerTùy chọn

    Id quốc gia từ catalog. Bỏ trống để lấy vị trí bất kỳ còn hàng.

  • cityIdintegerTùy chọn

    Id bang từ catalog.

  • spIdintegerTùy chọn

    Id nhà mạng từ catalog.

  • modemIdstringTùy chọn

    Id modem lấy từ /mobile/catalog?modems=1 (cùng gói). Cần cityId và quantity 1. Trả 409 modem_taken nếu modem hết chỗ; bạn không bị trừ tiền.

  • protocolstringTùy chọn

    Giao thức của cổng.

    sockshttpMặc định: 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"
  }'
Phản hồi201
{
  "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
}

đổi quốc gia/bang/nhà mạng (miễn phí)

POST/mobile/proxies/{id}/switch

Phạm vi: write:proxies

Tham số đường dẫn

  • idstringBắt buộc

    Id của proxy di động.

Tham số body

  • countryIdintegerBắt buộc

    Id quốc gia từ catalog.

  • cityIdintegerTùy chọn

    Id bang từ catalog.

  • spIdintegerTùy chọn

    Id nhà mạng từ catalog.

  • modemIdstringTùy chọn

    Id modem lấy từ danh sách modem. Cần cityId. Port chỉ chuyển sang đúng modem đó: 409 modem_taken nếu modem đầy, 404 modem_gone nếu modem không còn trong danh sách.

  • protocolstringTùy chọn

    Mặc định giữ giao thức hiện tại của cổng.

    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"
  }'
Phản hồi200
{
  "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}

liệt kê modem của một bang cho port (rảnh và bận, thời gian giữ IP)

GET/mobile/proxies/{id}/modems

Phạm vi: read:proxies

Tham số đường dẫn

  • idstringBắt buộc

    Id của proxy di động.

Tham số query

  • stateintegerBắt buộc

    Id bang trong catalog. Liệt kê modem của bang đó theo gói của port này.

  • carrierintegerTùy chọn

    Id nhà mạng. Với modems=1, chỉ liệt kê modem của nhà mạng đó.

curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/modems?state=12&carrier=34" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Phản hồi200
{
  "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 thoát mới (miễn phí)

POST/mobile/proxies/{id}/rotate

Phạm vi: write:proxies

Tham số đường dẫn

  • idstringBắt buộc

    Id của proxy di động.

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/rotate" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Phản hồi200
{
  "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}

đọc IP thoát trực tiếp

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

Phạm vi: read:proxies

Tham số đường dẫn

  • idstringBắt buộc

    Id của proxy di động.

curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/check-ip" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Phản hồi200
{
  "data": { "ip": "174.208.161.27" }
}

chuyển SOCKS5 ↔ HTTP(S)

POST/mobile/proxies/{id}/protocol

Phạm vi: write:proxies

Tham số đường dẫn

  • idstringBắt buộc

    Id của proxy di động.

Tham số body

  • protocolstringBắt buộc

    Giao thức của cổng.

    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"
  }'
Phản hồi200
{
  "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}

đổi kiểu xác thực

POST/mobile/proxies/{id}/auth

Phạm vi: write:proxies

Tham số đường dẫn

  • idstringBắt buộc

    Id của proxy di động.

Tham số body

  • modestringBắt buộc

    userpass đăng nhập bằng tên và mật khẩu; whitelist cho các IP trong danh sách kết nối không cần mật khẩu.

    userpasswhitelist

  • allowedIpsstring[]Tùy chọn

    Tối đa 3 địa chỉ IPv4 hoặc IPv6 công khai, không dùng dải. Cần cho whitelist.

    Mặc định: []

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"
    ]
  }'
Phản hồi200
{
  "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}

gia hạn cổng (trừ vào số dư)

POST/mobile/proxies/{id}/renew

Phạm vi: purchase

Tham số đường dẫn

  • idstringBắt buộc

    Id của proxy di động.

Tham số body

  • durationKeystringBắt buộc

    Thời hạn thuê. Phải là thời hạn gói của cổng có bán.

    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"
  }'
Phản hồi200
{
  "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}

Sẵn sàng xây dựng?

Tạo thông tin đăng nhập trong dashboard hoặc tạo một API key để tự động hóa.