เอกสาร 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{
"code": "S5-7KQ2-M8PX-4HDA",
"balance": "125.40",
"currency": "USD",
"active_plans": 2,
"proxies": 125,
"created_at": "2026-10-22T08:15:02.114Z"
}ดูรายการแผนบริการ: 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 จะมีทั้งสองพอร์ต
| คิวรี | ค่า | คำอธิบาย |
|---|---|---|
| country | us, de, jp และอื่นๆ | เฉพาะพร็อกซี่จากประเทศนั้น |
| plan | P-XXXXX-XXXXX | เฉพาะพร็อกซี่จากแผนนั้น |
| protocol | http, socks5 | http พื้นฐาน |
| format | json | ค่าเริ่มต้น รูปแบบอื่นดูที่ /proxies/download |
curl -H "Authorization: Bearer spx_your_api_key" \
"https://socks5proxy.io/api/v1/proxies?country=us&protocol=socks5"{
"count": 1,
"protocol": "socks5",
"proxies": [
{
"host": "198.51.100.23",
"http_port": 8231,
"socks5_port": 1080,
"username": "spx_k2m8qa",
"password": "q7rbx2wd9n",
"country": "us",
"city": "New York",
"plan": "P-8WQ4C-NM2KT",
"product": "dc-private",
"product_name": "Private Datacenter Proxy",
"expires_at": "2026-11-22T08:20:11.002Z"
}
]
}ดาวน์โหลดรายการ: 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:port | spx_k2m8qa:q7rbx2wd9n@198.51.100.23:1080 |
| ip:port | 198.51.100.23:1080 |
| url | socks5://spx_k2m8qa:q7rbx2wd9n@198.51.100.23:1080 |
| csv | 198.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())import { ProxyAgent, fetch } from "undici";
const API = "https://socks5proxy.io/api/v1";
const H = { Authorization: "Bearer spx_your_api_key" };
const { proxies } = await (await fetch(`${API}/proxies?country=us`, { headers: H })).json();
const p = proxies[0];
const agent = new ProxyAgent(`http://${p.username}:${p.password}@${p.host}:${p.http_port}`);
const r = await fetch("https://api.ipify.org?format=json", { dispatcher: agent });
console.log(await r.json());<?php
$ch = curl_init("https://socks5proxy.io/api/v1/proxies/download?format=ip:port:user:pass&protocol=http");
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ["Authorization: Bearer spx_your_api_key"],
CURLOPT_RETURNTRANSFER => true,
]);
$lines = explode("\n", trim(curl_exec($ch)));
[$host, $port, $user, $pass] = explode(":", $lines[0]);
echo "$host:$port\n";รหัสข้อผิดพลาดและขีดจำกัดการเรียกใช้
ข้อผิดพลาดจะส่งกลับในรูปแบบ { "error": { "code", "message" } } พร้อมรหัสสถานะ HTTP แต่ละคีย์สามารถเรียกใช้ได้สูงสุด 300 ครั้งต่อนาที หากเกินจะได้รับคำตอบ 429 เป็นเวลา 1 นาที เนื่องจากรายการเปลี่ยนแปลงเฉพาะตอนซื้อหรือหมดอายุ แนะนำให้ดึงข้อมูลทุกๆ สองสามนาทีและใช้ซ้ำในโปรแกรม
การเรียก API ไม่มีค่าใช้จ่าย ยอดคงเหลือจะลดลงเฉพาะเมื่อซื้อแผนในแดชบอร์ด
| สถานะ | code | ความหมาย |
|---|---|---|
| 401 | unauthorized | ไม่มีคีย์หรือคีย์ผิดพลาด หากสร้างคีย์ใหม่ ให้ใช้คีย์ใหม่ |
| 400 | bad_format | ไม่มีค่า format ในรายการ |
| 404 | not_found | เส้นทางที่ไม่มีอยู่ |
| 429 | rate_limited | เกิน 300 ครั้งต่อนาที |