Socks5Proxy

เอกสาร API Proxy: รับรายการ Proxy ผ่าน REST API

Socks5Proxy API เป็น REST API ที่ใช้ API Key เดียวจากแดชบอร์ดเพื่อดึงยอดคงเหลือในบัญชี แผนที่ซื้อ และรายการพร็อกซีในรูปแบบ JSON หรือ txt/csv ที่อยู่ default คือ https://socks5proxy.io/api/v1 และสามารถเรียกได้สูงสุด 300 ครั้งต่อนาทีต่อ Key

ทำอะไรได้บ้างด้วย API

ใช้ API เมื่อต้องการให้โปรแกรมที่ใช้พร็อกซี่ดึงรายการล่าสุดโดยตรง คุณสามารถให้ครอว์เลอร์ดึงรายการทุกครั้งที่เริ่มต้น หรือให้เซิร์ฟเวอร์เปลี่ยนรายการอัตโนมัติเมื่อซื้อแผนใหม่หรือเมื่อแผนสิ้นสุด รายการที่ดาวน์โหลดจากแดชบอร์ดและรายการที่ได้รับผ่าน API เป็นข้อมูลเดียวกัน

API เป็นแบบอ่านเท่านั้น สนับสนุนการตรวจสอบยอดคงเหลือ รายการแผน และรายการพร็อกซี่ การชำระเงินและการซื้อทำในแดชบอร์ด ทุกคำตอบเป็น UTF-8 และวันที่เป็นรูปแบบ ISO 8601 UTC

เมธอดเส้นทางคำอธิบาย
GET/accountรหัสบัญชี ยอดคงเหลือ (USD) จำนวนแผนที่ใช้งานอยู่ จำนวนพร็อกซี
GET/plansรายการแผนที่ซื้อ (ล่าสุด 200 รายการ) สถานะและเวลาหมดอายุ
GET/proxiesรายการพร็อกซี่ที่ใช้งานอยู่ (JSON), กรองตามประเทศและแผน
GET/proxies/downloadรับรายการพร็อกซี่ในรูปแบบ txt หรือ csv แบบบรรทัดเดียว

สร้างและส่งคีย์ API อย่างไร

สร้างคีย์ API ในหน้าคีย์ API ของแดชบอร์ด คีย์จะเริ่มต้นด้วย spx_ และมีความยาว 44 ตัวอักษร และจะแสดงเพียงครั้งเดียวตอนสร้าง เซิร์ฟเวอร์จะเก็บเฉพาะลายนิ้วมือ (แฮช) ของคีย์เท่านั้น ดังนั้นหากสูญหายคุณสามารถสร้างคีย์ใหม่ได้ และเมื่อสร้างคีย์ใหม่ คีย์เก่าจะไม่สามารถใช้งานได้ทันที

ใส่คีย์ในหัวข้อ Authorization ด้วยวิธี Bearer ในทุกการร้องขอ เราไม่รองรับการใส่คีย์ใน query string ของ URL หากไม่มีคีย์หรือคีย์ผิดจะตอบกลับด้วย 401 unauthorized

curl -H "Authorization: Bearer spx_your_api_key" https://socks5proxy.io/api/v1/account

ตรวจสอบข้อมูลบัญชีและยอดเงิน: GET /account

ส่งคืนรหัสบัญชี ยอดคงเหลือ จำนวนแผนที่ใช้งานอยู่ และจำนวนพร็อกซี ยอดคงเหลือเป็นทศนิยมสองตำแหน่ง (USD)

curl -H "Authorization: Bearer spx_your_api_key" https://socks5proxy.io/api/v1/account

ดูรายการแผนบริการ: GET /plans

แสดงรายการแผนที่ซื้อเรียงจากล่าสุด สถานะจะเป็น active(ใช้งานอยู่), expired(หมดอายุ), canceled(ยกเลิก) หนึ่งในนี้ id คือรหัสแผน (ขึ้นต้นด้วย P-) และสามารถใช้เป็นค่า plan ใน /proxies ได้

{
  "plans": [
    {
      "id": "P-8WQ4C-NM2KT",
      "product": "dc-private",
      "product_name": "Private Datacenter Proxy",
      "ips": 100,
      "months": 1,
      "country": "us",
      "status": "active",
      "amount": "49.40",
      "created_at": "2026-10-22T08:20:11.002Z",
      "expires_at": "2026-11-22T08:20:11.002Z"
    }
  ]
}

ค้นหารายการ Proxy: GET /proxies

ส่งคืนพร็อกซี่ของแผนที่ใช้งานอยู่ในรูปแบบ JSON โดยแต่ละพร็อกซี่จะมีที่อยู่, พอร์ต HTTP, พอร์ต SOCKS5, ชื่อผู้ใช้, รหัสผ่าน, ประเทศ, เมือง, รหัสแผน, และเวลาหมดอายุ

คุณสามารถกรองด้วย country (รหัสประเทศสองตัวอักษร เช่น us) และ plan (รหัสแผน) ค่า protocol จะแสดงในคำตอบและ JSON จะมีทั้งสองพอร์ต

คิวรีค่าคำอธิบาย
countryus, de, jp และอื่นๆเฉพาะพร็อกซี่จากประเทศนั้น
planP-XXXXX-XXXXXเฉพาะพร็อกซี่จากแผนนั้น
protocolhttp, socks5http พื้นฐาน
formatjsonค่าเริ่มต้น รูปแบบอื่นดูที่ /proxies/download
curl -H "Authorization: Bearer spx_your_api_key" \
  "https://socks5proxy.io/api/v1/proxies?country=us&protocol=socks5"

ดาวน์โหลดรายการ: GET /proxies/download

ส่งคืน Proxy เป็นข้อความทีละบรรทัดเพื่อให้โปรแกรมอ่านได้ทันที หาก protocol เป็น socks5 จะใช้พอร์ต SOCKS5 หากเป็น http จะใช้พอร์ต HTTP format=url จะเพิ่มคำนำหน้า (socks5:// หรือ http://) ตาม protocol

ในเซิร์ฟเวอร์ที่เปิดใช้งาน IP Authorization สามารถเชื่อมต่อได้ทันทีในรูปแบบ ip:port โดยไม่ต้องใช้ชื่อผู้ใช้ CSV มีชื่อคอลัมน์ในบรรทัดแรกและรวมทั้งสองพอร์ต

formatตัวอย่างหนึ่งบรรทัด (protocol=socks5)
ip:port:user:pass (พื้นฐาน)198.51.100.23:1080:spx_k2m8qa:q7rbx2wd9n
user:pass@ip:portspx_k2m8qa:q7rbx2wd9n@198.51.100.23:1080
ip:port198.51.100.23:1080
urlsocks5://spx_k2m8qa:q7rbx2wd9n@198.51.100.23:1080
csv198.51.100.23,8231,1080,spx_k2m8qa,q7rbx2wd9n,us,นิวยอร์ก
curl -H "Authorization: Bearer spx_your_api_key" \
  "https://socks5proxy.io/api/v1/proxies/download?format=url&protocol=socks5" -o proxies.txt

ตัวอย่างโค้ด: Python, Node.js, PHP

ตัวอย่างด้านล่างแสดงการรับรายการและส่งคำขอไปยังพร็อกซี่ตัวแรก หากต้องการใช้ SOCKS5 ใน Python คุณต้องใช้แพ็คเกจ requests[socks] และหากใช้ socks5h การตรวจสอบชื่อโดเมนจะทำที่ฝั่งพร็อกซี่

import requests

API = "https://socks5proxy.io/api/v1"
H = {"Authorization": "Bearer spx_your_api_key"}

proxies = requests.get(f"{API}/proxies", headers=H, params={"country": "us"}).json()["proxies"]
p = proxies[0]
url = f"socks5h://{p['username']}:{p['password']}@{p['host']}:{p['socks5_port']}"
r = requests.get("https://api.ipify.org?format=json", proxies={"http": url, "https": url}, timeout=30)
print(r.json())

รหัสข้อผิดพลาดและขีดจำกัดการเรียกใช้

ข้อผิดพลาดจะส่งกลับในรูปแบบ { "error": { "code", "message" } } พร้อมรหัสสถานะ HTTP แต่ละคีย์สามารถเรียกใช้ได้สูงสุด 300 ครั้งต่อนาที หากเกินจะได้รับคำตอบ 429 เป็นเวลา 1 นาที เนื่องจากรายการเปลี่ยนแปลงเฉพาะตอนซื้อหรือหมดอายุ แนะนำให้ดึงข้อมูลทุกๆ สองสามนาทีและใช้ซ้ำในโปรแกรม

การเรียก API ไม่มีค่าใช้จ่าย ยอดคงเหลือจะลดลงเฉพาะเมื่อซื้อแผนในแดชบอร์ด

สถานะcodeความหมาย
401unauthorizedไม่มีคีย์หรือคีย์ผิดพลาด หากสร้างคีย์ใหม่ ให้ใช้คีย์ใหม่
400bad_formatไม่มีค่า format ในรายการ
404not_foundเส้นทางที่ไม่มีอยู่
429rate_limitedเกิน 300 ครั้งต่อนาที
เอกสาร API Proxy, การเชื่อมต่อ REST API สำหรับรายการ Proxy | Socks5Proxy