ProxyWorld API

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

รับคีย์ APIดูเอนด์พอยต์

เพิ่งเริ่มใช้? ทำตามขั้นตอนนี้

  1. 1สมัครด้วยอีเมลและรหัสผ่าน หรือด้วยโทเค็น แล้วเปิดแดชบอร์ด
  2. 2ออกคีย์ API ในแท็บ Connect คีย์เต็มจะแสดงเพียงครั้งเดียวตอนออกคีย์ จึงควรบันทึกไว้ทันที
  3. 3ใส่คีย์ในเฮดเดอร์ Authorization ของทุกคำขอที่ต้องใช้คีย์
  4. 4เรียก /account ก่อนเพื่อตรวจสอบว่าคีย์ใช้ได้ แล้วสั่งซื้อด้วย /orders

การยืนยันตัวตนทำงานอย่างไร?

คำขอที่เกี่ยวกับบัญชีของคุณ (account, orders, proxy-user) ต้องใช้คีย์ API ส่งในเฮดเดอร์เป็น Authorization: Bearer pwk_... ส่วนราคา ประเทศ และใบเสนอราคาเปิดให้ทุกคนเรียกได้โดยไม่ต้องใช้คีย์

เซิร์ฟเวอร์ ProxyWorld ไม่เก็บตัวคีย์ เก็บเพียงค่าแฮชเท่านั้น หากคีย์หาย ให้สร้างคีย์ใหม่ในแดชบอร์ด แล้วคีย์เดิมจะถูกบล็อกทันที ใส่คีย์ไว้ในโค้ดฝั่งเซิร์ฟเวอร์เท่านั้น หากคีย์ไปอยู่ในโค้ดที่ทำงานบนเบราว์เซอร์หรือใน repository สาธารณะ คนอื่นจะนำไปใช้ได้

HTTP header
Authorization: Bearer pwk_your_api_key

Base URL และรูปแบบข้อมูล

Base URL
https://proxyworld.shop/api/v1
เนื้อหาคำขอและการตอบกลับ
application/json
จำนวนเงิน
USD เป็นตัวเลข เช่น 1058.50
เวลา
ISO 8601 (UTC)

เรียกใช้ได้กี่ครั้ง?

คีย์ API แต่ละคีย์เรียกได้ 60 ครั้งต่อนาที เอนด์พอยต์สาธารณะที่เรียกโดยไม่ใช้คีย์ได้ 60 ครั้งต่อนาทีต่อ IP หากเกินจะได้ HTTP 429 รอประมาณ 1 นาทีแล้วลองใหม่

ถ้าเกิดข้อผิดพลาดจะได้อะไรกลับมา?

คุณจะได้รหัสสถานะ HTTP และเนื้อหา JSON ที่มีรหัสข้อผิดพลาดสั้น ๆ พร้อมคำอธิบาย

ตัวอย่าง
{
  "error": {
    "code": "insufficient_balance",
    "message": "Your balance is too low for this order. Top up in the dashboard."
  }
}
code
bad_requestHTTP 400ขาดค่าที่จำเป็น หรือส่งค่าที่สินค้านี้ไม่รองรับ
unauthorizedHTTP 401ไม่มีคีย์ API หรือคีย์ไม่ถูกต้อง
insufficient_balanceHTTP 402ยอดเงินน้อยกว่ายอดรวมของคำสั่งซื้อ ไม่มีการหักเงินจากยอดเงิน
not_foundHTTP 404บัญชีของคุณไม่มีคำสั่งซื้อหมายเลขนี้
rate_limitedHTTP 429คุณเรียกใช้เกินจำนวนครั้งที่อนุญาตต่อนาที
server_errorHTTP 500เซิร์ฟเวอร์ดำเนินการคำขอไม่สำเร็จ ไม่มีการหักเงินจากยอดเงิน

เอนด์พอยต์

ดูบัญชีของคุณ

GET/api/v1/accountต้องใช้คีย์ API

แสดงวิธีเข้าสู่ระบบ (login: email หรือ token) อีเมล ยอดเงิน โฮสต์และพอร์ตพร็อกซี่ ชื่อผู้ใช้และรหัสผ่านพร็อกซี่ และ IP ที่อนุญาต สำหรับบัญชีที่สร้างด้วยโทเค็น email จะเป็น null

คำขอ
curl https://proxyworld.shop/api/v1/account \
  -H "Authorization: Bearer pwk_your_api_key"
การตอบกลับ
{
  "login": "email",
  "email": "you@example.com",
  "balance_usd": 1300,
  "proxy": {
    "host": "gate.proxyworld.shop",
    "http_port": 6100,
    "socks5_port": 6200,
    "username": "pwexample1",
    "password": "your_password"
  },
  "allowed_ips": [
    "203.0.113.10"
  ]
}

ดูสินค้าและราคา

GET/api/v1/productsใช้ได้โดยไม่ต้องมีคีย์

แสดงช่วงการสั่งซื้อของแต่ละสินค้า ราคาต่อหน่วยในแต่ละขั้นจำนวน และส่วนลดตามระยะเวลา ใช้ตารางราคาเดียวกับหน้าราคา

คำขอ
curl https://proxyworld.shop/api/v1/products
การตอบกลับ
{
  "currency": "USD",
  "prices_as_of": "2026-10-31",
  "products": [
    {
      "id": "unlimited",
      "unit": "day",
      "quantity": {
        "meaning": "days",
        "min": 1,
        "max": 365
      },
      "...": "..."
    },
    {
      "id": "residential",
      "unit": "gb",
      "...": "..."
    }
  ]
}

ประเทศและเมือง

GET/api/v1/countriesใช้ได้โดยไม่ต้องมีคีย์

แสดงประเทศที่เลือกได้สำหรับแต่ละสินค้า พร้อมค่าเมืองที่ใช้กับตัวเลือก -city- ในชื่อผู้ใช้

ชื่อความหมาย
productไม่บังคับหนึ่งใน unlimited, residential, isp, datacenter หากไม่ระบุจะใช้ residential
คำขอ
curl "https://proxyworld.shop/api/v1/countries?product=datacenter"
การตอบกลับ
{
  "product": "datacenter",
  "countries": [
    {
      "code": "us",
      "name": "United States",
      "region": "americas",
      "datacenter": true,
      "cities": [
        {
          "name": "New York",
          "value": "new_york"
        },
        {
          "name": "Los Angeles",
          "value": "los_angeles"
        }
      ]
    }
  ]
}

ขอใบเสนอราคา

POST/api/v1/quoteใช้ได้โดยไม่ต้องมีคีย์

คำนวณยอดรวมของคำสั่งซื้อโดยไม่หักยอดเงิน ส่งเนื้อหาเดียวกับที่ใช้สั่งซื้อจริง

ชื่อความหมาย
productจำเป็นหนึ่งใน unlimited, residential, isp, datacenter
quantityจำเป็นจำนวนที่สั่ง: จำนวนวันสำหรับ unlimited (1~365), GB สำหรับ residential (5~5,000), จำนวน IP สำหรับ isp (1~1,000) หรือ datacenter (5~5,000)
concurrencyไม่บังคับเฉพาะ unlimited เลือก 200, 500, 1000 หรือ 2000
bandwidthไม่บังคับเฉพาะ unlimited หน่วย Mbps เลือก 100, 200, 500 หรือ 1000
monthsไม่บังคับเฉพาะ isp และ datacenter เลือก 1, 3, 6 หรือ 12
countryไม่บังคับเฉพาะ isp และ datacenter รหัสประเทศ 2 ตัวอักษร เช่น jp ค่าที่ใช้ได้ดูใน /countries
คำขอ
curl -X POST https://proxyworld.shop/api/v1/quote \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'
การตอบกลับ
{
  "product": "unlimited",
  "quantity": 30,
  "unit_price_usd": 8.05,
  "unit": "day",
  "total_usd": 241.5
}

สั่งซื้อ

POST/api/v1/ordersต้องใช้คีย์ API

หักยอดรวมจากยอดเงินและสร้างคำสั่งซื้อ เริ่มต้นเป็น pending (กำลังเปิดใช้งาน) และเปลี่ยนเป็น active เมื่อพร้อม คำสั่งซื้อที่เปิดใช้งานไม่ได้จะเป็น refunded และเงินทั้งหมดที่จ่ายจะคืนเข้ายอดเงิน หากยอดเงินไม่พอจะได้ 402

ชื่อความหมาย
productจำเป็นหนึ่งใน unlimited, residential, isp, datacenter
quantityจำเป็นจำนวนที่สั่ง: จำนวนวันสำหรับ unlimited (1~365), GB สำหรับ residential (5~5,000), จำนวน IP สำหรับ isp (1~1,000) หรือ datacenter (5~5,000)
concurrencyไม่บังคับเฉพาะ unlimited เลือก 200, 500, 1000 หรือ 2000
bandwidthไม่บังคับเฉพาะ unlimited หน่วย Mbps เลือก 100, 200, 500 หรือ 1000
monthsไม่บังคับเฉพาะ isp และ datacenter เลือก 1, 3, 6 หรือ 12
countryไม่บังคับเฉพาะ isp และ datacenter รหัสประเทศ 2 ตัวอักษร เช่น jp ค่าที่ใช้ได้ดูใน /countries
คำขอ
curl -X POST https://proxyworld.shop/api/v1/orders \
  -H "Authorization: Bearer pwk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'
การตอบกลับ
{
  "order": {
    "id": "PW-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.05,
    "total_usd": 241.5,
    "status": "pending",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:12:44.120Z"
  },
  "balance_usd": 1058.5
}

ดูคำสั่งซื้อของคุณ

GET/api/v1/ordersต้องใช้คีย์ API

แสดงคำสั่งซื้อสูงสุด 100 รายการ เรียงจากล่าสุด

ชื่อความหมาย
statusไม่บังคับหนึ่งใน pending, active, refunded ไม่ใส่เพื่อดูคำสั่งซื้อทุกสถานะ
คำขอ
curl "https://proxyworld.shop/api/v1/orders?status=pending" \
  -H "Authorization: Bearer pwk_your_api_key"
การตอบกลับ
{
  "orders": [
    {
      "id": "PW-7KQ2M-X4HTD",
      "product": "unlimited",
      "quantity": 30,
      "months": null,
      "concurrency": 1000,
      "bandwidth_mbps": 200,
      "country": null,
      "unit_price_usd": 8.05,
      "total_usd": 241.5,
      "status": "pending",
      "created_at": "2026-10-31T09:12:44.120Z",
      "updated_at": "2026-10-31T09:12:44.120Z"
    }
  ]
}

ดูคำสั่งซื้อรายการเดียว

GET/api/v1/orders/{id}ต้องใช้คีย์ API

แสดงคำสั่งซื้อที่ตรงกับหมายเลขคำสั่งซื้อ ใช้ตรวจสอบว่าเปิดใช้งานเสร็จแล้วหรือยัง

ชื่อความหมาย
idจำเป็นหมายเลขคำสั่งซื้อ เช่น PW-7KQ2M-X4HTD
คำขอ
curl https://proxyworld.shop/api/v1/orders/PW-7KQ2M-X4HTD \
  -H "Authorization: Bearer pwk_your_api_key"
การตอบกลับ
{
  "order": {
    "id": "PW-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.05,
    "total_usd": 241.5,
    "status": "active",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:40:02.511Z"
  }
}

สร้างชื่อผู้ใช้พร็อกซี่

GET/api/v1/proxy-userต้องใช้คีย์ API

แสดงชื่อผู้ใช้พร็อกซี่พร้อมตัวเลือกของคุณ และ URL แบบ HTTP และ SOCKS5 ที่วางใช้ได้ทันที หากไม่ส่ง session IP จะเปลี่ยนทุกคำขอ

ชื่อความหมาย
productไม่บังคับหนึ่งใน unlimited, residential, isp, datacenter หากไม่ระบุจะใช้ unlimited
countryไม่บังคับรหัสประเทศ 2 ตัวอักษร เช่น jp
cityไม่บังคับค่าเมืองที่อยู่ใน /countries เช่น tokyo ต้องส่ง country ไปด้วย
sessionไม่บังคับตัวอักษรและตัวเลข 1~32 ตัว คำขอที่ใช้ session เดียวกันจะใช้ IP เดียวกัน
ttlไม่บังคับระยะเวลาที่เซสชันคง IP ไว้ 1~60 นาที หากไม่ระบุคือ 30 นาที
คำขอ
curl "https://proxyworld.shop/api/v1/proxy-user?product=residential&country=jp&city=tokyo&session=job42&ttl=30" \
  -H "Authorization: Bearer pwk_your_api_key"
การตอบกลับ
{
  "username": "pwexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30",
  "password": "your_password",
  "http": "http://pwexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.proxyworld.shop:6100",
  "socks5": "socks5h://pwexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.proxyworld.shop:6200"
}

ตัวอย่างตั้งแต่ต้นจนจบ

สคริปต์เดียวที่ขอใบเสนอราคา สั่งซื้อจากยอดเงิน แล้วเชื่อมต่อผ่าน IP ในญี่ปุ่น

Python (requests)
import requests

API = "https://proxyworld.shop/api/v1"
HEAD = {"Authorization": "Bearer pwk_your_api_key"}

# 1) Check the price first
plan = {"product": "residential", "quantity": 100}
print(requests.post(f"{API}/quote", json=plan).json())

# 2) Order from your balance
r = requests.post(f"{API}/orders", json=plan, headers=HEAD)
order = r.json()["order"]
print(order["id"], order["status"])

# 3) Get a username for Japanese IPs
u = requests.get(f"{API}/proxy-user", headers=HEAD,
                 params={"product": "residential", "country": "jp"}).json()
proxies = {"http": u["http"], "https": u["http"]}
print(requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30).json())
Node.js 18+
const API = "https://proxyworld.shop/api/v1";
const HEAD = { Authorization: "Bearer pwk_your_api_key", "Content-Type": "application/json" };

// Check the balance
const acc = await fetch(`${API}/account`, { headers: HEAD }).then((r) => r.json());
console.log(acc.balance_usd);

// Order 7 days of unlimited
const res = await fetch(`${API}/orders`, {
  method: "POST",
  headers: HEAD,
  body: JSON.stringify({ product: "unlimited", quantity: 7, concurrency: 500, bandwidth: 100 }),
});
if (res.status === 402) console.log("Top up first");
else console.log((await res.json()).order.id);

คำสั่งซื้อผ่าน API ดำเนินการเหมือนคำสั่งซื้อในแดชบอร์ด และแสดงในแท็บประวัติร่วมกับรายการอื่น เปลี่ยน pwk_your_api_key ในตัวอย่างเป็นคีย์ API ของคุณ

เชื่อมต่อ ProxyWorld กับโค้ดของคุณ

สมัครด้วยอีเมลหรือโทเค็น สร้างคีย์ API ในแดชบอร์ด แล้วเริ่มเรียกใช้ได้ทันที

สร้างบัญชีฟรีวิธีเชื่อมต่อ