Đăng nhập
Cloud VPS Hosting Tên miền Proxy
Cloud VPS Hosting Tên miền Quản lý Proxy
Trang chủ
Dịch vụ
Nạp tiền
Lịch sử
Tài khoản

Tài liệu API Proxy

Tài liệu tích hợp API Proxy của DICHVUDARK.VIP Trang Web Cung Dữ Liệu Đám Mây Uy Tín Nhất Việt Nam.: lấy danh sách gói, mua proxy, quản lý đơn hàng, kiểm tra live/die & ping, gia hạn và đồng bộ IP.

Xác thực tài khoản (Authentication API)

X-Api-Token / Bearer
Chưa đăng nhập tài khoản

Vui lòng Đăng nhập hoặc Đăng ký để xem API Token cá nhân của bạn và tự động nạp vào các ví dụ cURL.

Định dạng Header mặc định: X-Api-Token: YOUR_API_TOKEN hoặc Authorization: Bearer YOUR_API_TOKEN
4 Cách truyền Token:
  • Header: X-Api-Token: {token}
  • Header: Authorization: Bearer {token}
  • Query URL: ?token={token}
  • Body JSON: {"token": "{token}"}
GET

1. Danh sách gói Proxy

Lấy danh sách các gói proxy đang kinh doanh theo vị trí, loại và giá bán đã được cấu hình.

GET https://dichvudark.vip/api/proxy/packages
curl -X GET "https://dichvudark.vip/api/proxy/packages" \ -H "X-Api-Token: YOUR_API_TOKEN" \ -H "Content-Type: application/json"
{
  "status": "success",
  "data": [{
    "id": 1,
    "name": "Proxy Dân Cư US Cao Cấp",
    "location": "residential",
    "type": "share",
    "duration_days": 30,
    "min_days": 1,
    "price": 60000
  }]
}
POST

2. Mua Proxy mới

Mua proxy tự động: kiểm tra số dư ví tài khoản, tạo đơn hàng và xuất thông tin kết nối IP:Port:User:Pass.

POST https://dichvudark.vip/api/proxy/buy
TrườngLoạiMô tả
package_idBắt buộcID gói proxy
daysBắt buộcSố ngày mua (tối thiểu theo min_days)
quantityBắt buộcSố lượng proxy
protocolMặc định: HTTPHTTP hoặc SOCKS5
username, passwordTuỳ chọnTài khoản proxy tuỳ chỉnh (mặc định: random)
curl -X POST "https://dichvudark.vip/api/proxy/buy" \ -H "X-Api-Token: YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"package_id":1,"days":30,"quantity":1,"protocol":"HTTP","username":"random","password":"random"}'
{
  "status": "success",
  "data": [{
    "id": 105,
    "ip_address": "104.28.19.45",
    "port": 9050,
    "username": "usr_99812",
    "password": "pwd_77612"
  }]
}
GET

3. Thông tin tài khoản & Số dư

Xem thông tin tài khoản Proxy, số dư ví khả dụng và chiết khấu hiện tại.

GET https://dichvudark.vip/api/proxy/profile
curl -X GET "https://dichvudark.vip/api/proxy/profile" \ -H "X-Api-Token: YOUR_API_TOKEN" \ -H "Content-Type: application/json"
{
  "status": "success",
  "data": {
    "username": "reseller01",
    "name": "Đại lý VIP",
    "cash": 500000,
    "discount": "10%",
    "level": 2
  }
}
POST

4. Gia hạn Proxy

Gia hạn một hoặc nhiều proxy cùng lúc theo danh sách ID đơn hàng.

POST https://dichvudark.vip/api/proxy/renew
TrườngLoạiMô tả
idsBắt buộcMảng ID hoặc chuỗi ID cách nhau dấu phẩy
daysBắt buộcSố ngày gia hạn thêm
locationBắt buộcVị trí proxy (residential, datacenter)
curl -X POST "https://dichvudark.vip/api/proxy/renew" \ -H "X-Api-Token: YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"ids":[105],"days":30,"location":"residential"}'
GET

5. Danh sách Proxy đã mua

Lấy danh sách các proxy của tài khoản, hỗ trợ phân trang và lọc theo trạng thái (active, expired, pending).

GET https://dichvudark.vip/api/proxy/orders?page=1&limit=20&status=active
QueryLoạiMô tả
pageMặc định: 1Số trang hiện tại
limitMặc định: 20Số lượng proxy mỗi trang (tối đa 100)
statusTuỳ chọnTrạng thái: active, expired, pending
curl -X GET "https://dichvudark.vip/api/proxy/orders?page=1&limit=20" \ -H "X-Api-Token: YOUR_API_TOKEN" \ -H "Content-Type: application/json"
{
  "status": "success",
  "data": {
    "items": [{
      "id": 15,
      "package_name": "Proxy Dân Cư US Cao Cấp",
      "ip_address": "104.28.19.45",
      "port": 9050,
      "protocol": "HTTP",
      "status": "active",
      "expired_at": "2026-10-29 23:59:59"
    }],
    "pagination": { "current_page": 1, "total_pages": 1, "total_records": 1 }
  }
}
POST

6. Kiểm tra Live / Die & Ping

Test kết nối thực tế tới proxy: kiểm tra sống/chết (live/die), tốc độ phản hồi (ping ms) và IP public đi ra.

POST https://dichvudark.vip/api/proxy/check
TrườngLoạiMô tả
proxyBắt buộcĐịnh dạng: ip:port hoặc ip:port:user:pass
protocolMặc định: HTTPHTTP hoặc SOCKS5
timeoutMặc định: 10Timeout kết nối (giây)
curl -X POST "https://dichvudark.vip/api/proxy/check" \ -H "X-Api-Token: YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"proxy":"104.28.19.45:9050:user123:pass456","protocol":"HTTP"}'
{
  "status": "success",
  "data": {
    "live": true,
    "ping_ms": 142,
    "ip": "104.28.19.45",
    "protocol": "HTTP"
  }
}
GET

7. Tra cứu chi tiết Proxy

Tra cứu thông tin chi tiết proxy theo danh sách ID và khu vực.

GET https://dichvudark.vip/api/proxy/info?ids=123,124&location=residential
curl -X GET "https://dichvudark.vip/api/proxy/info?ids=123,124&location=residential" \ -H "X-Api-Token: YOUR_API_TOKEN" \ -H "Content-Type: application/json"
POST

8. Đồng bộ IP mới nhất

Yêu cầu nhà cung cấp đổi hoặc làm mới địa chỉ IP cho proxy đã mua.

POST https://dichvudark.vip/api/proxy/sync-ip
curl -X POST "https://dichvudark.vip/api/proxy/sync-ip" \ -H "X-Api-Token: YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"ids":[123],"location":"residential"}'

Code Mẫu & SDK Tích Hợp

Hệ thống cung cấp sẵn SDK Client viết bằng PHP thuần không cần cài thư viện ngoài, hoặc bạn có thể dùng Node.js với Axios để tích hợp tự động vào bot/hệ thống của mình:

<?php require_once __DIR__ . '/classes/DichVuDarkProxyAPI.php'; // Khởi tạo client với API Token của bạn $proxyApi = new DichVuDarkProxyAPI('https://dichvudark.vip', 'YOUR_API_TOKEN'); // 1. Lấy danh sách gói $packages = $proxyApi->getPackages(); // 2. Mua Proxy mới $buyResult = $proxyApi->buyProxy([ 'package_id' => 1, 'days' => 30, 'quantity' => 1, 'protocol' => 'HTTP' ]); // 3. Lấy danh sách đơn hàng đã mua $orders = $proxyApi->listOrders(1, 20, 'active'); // 4. Kiểm tra proxy live / die & ping $check = $proxyApi->checkProxy('104.28.19.45:9050:user:pass', 'HTTP'); if (!empty($check['data']['live'])) { echo "Proxy hoạt động tốt! Ping: " . $check['data']['ping_ms'] . "ms"; } ?>