API Tích Hợp Cloud VPS Agency

Mọi request tương tác với hệ sinh thái Cloud VPS qua chuẩn Agency cần bộ 3 thông số định danh tài khoản kết nối:

Request Body (JSON hoặc Form URL-encoded):

{
  "api-username": "your_agency_user",
  "api-app": "app_xxxxxxxxxxxxxxxx",
  "api-secret": "sec_yyyyyyyyyyyyyyyy"
}

Response mẫu:

{
  "status": true,
  "code": 200,
  "message": "Xác thực tài khoản thành công!",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expire_at": 1735689600
}

api-username: your_agency_user
api-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Response mẫu:

{
  "status": true,
  "code": 200,
  "data": {
    "username": "reseller_pro",
    "balance": 5250000,
    "discount": 10,
    "rank": "Đại lý Gold",
    "total_vps_active": 18
  }
}

Response khởi tạo thành công:

{
  "status": true,
  "code": 200,
  "message": "Khởi tạo Cloud VPS thành công!",
  "data": {
    "vps_id": 10842,
    "ip_address": "103.179.189.45",
    "username": "Administrator",
    "password": "VpsPassword#9821",
    "os": "Windows Server 2019 Datacenter",
    "specs": "2 vCPU / 4GB RAM / 40GB SSD NVMe",
    "expire_date": "2026-10-30 17:00:00",
    "total_paid": 171000
  }
}

Tất cả hành động điều khiển máy chủ được gom vào endpoint trên với tham số action:

Ví dụ payload khởi động lại:

{
  "vps_id": 10842,
  "action": "restart"
}

Ví dụ Class PHP chuẩn cURL kết nối tự động mua VPS và xử lý kết quả:

<?php
class DichVuDarkAgency {
    private $baseUrl = "https://www.host.tunthui.shop";
    private $username;
    private $appKey;
    private $secretKey;
    private $token = null;

    public function __construct($username, $appKey, $secretKey) {
        $this->username = $username;
        $this->appKey = $appKey;
        $this->secretKey = $secretKey;
    }

    public function getToken() {
        $ch = curl_init("{$this->baseUrl}/api/agency/get-token");
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => json_encode([
                "api-username" => $this->username,
                "api-app" => $this->appKey,
                "api-secret" => $this->secretKey
            ]),
            CURLOPT_HTTPHEADER => ["Content-Type: application/json"]
        ]);
        $res = json_decode(curl_exec($ch), true);
        curl_close($ch);
        if (@$res['status'] && !empty($res['token'])) {
            $this->token = $res['token'];
            return $this->token;
        }
        throw new Exception($res['message'] ?? 'Không lấy được Token');
    }

    public function createOrder($productId, $osId, $cycle = 1) {
        if (!$this->token) $this->getToken();
        $ch = curl_init("{$this->baseUrl}/api/agency/order/create-order");
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => json_encode([
                "product_id" => $productId,
                "os_id" => $osId,
                "billing_cycle" => $cycle
            ]),
            CURLOPT_HTTPHEADER => [
                "Content-Type: application/json",
                "api-username: {$this->username}",
                "api-token: {$this->token}"
            ]
        ]);
        $res = json_decode(curl_exec($ch), true);
        curl_close($ch);
        return $res;
    }
}

// Khởi tạo
$client = new DichVuDarkAgency("user_agency", "app_xxx", "sec_yyy");
$order = $client->createOrder(1, "Windows Server 2019", 1);
print_r($order);
?>