Tham chiếu API

API Tài khoản

Thông tin tài khoản sở hữu khoá (số dư, loại tài khoản, quyền khoá, chiết khấu đại lý) + nhật ký API. Mở cho thành viên lẫn đại lý.

Trên trang này
  1. Tổng quan
  2. GET /account/info
  3. GET /account/logs
  4. GET /services/status

Tổng quan

Địa chỉ gốc của các endpoint trên trang này:

Base URL
https://cloudmoon.net/api/v1
EndpointViệcQuyền khoá
GET /account/info Số dư ví, loại tài khoản (member/reseller/admin), quyền của khoá đang gọi, cấp đại lý + TB nạp/tháng, % chiết khấu từng… Chỉ đọc
GET /account/logs Nhật ký lượt gọi API của chính tài khoản (audit). Phân trang. Chỉ đọc
GET /services/status Trạng thái bật/tắt (bảo trì) của từng dịch vụ. Dịch vụ đang tắt: lệnh mua mới trả code SERVICE_DISABLED (HTTP 503); gia… Chỉ đọc
GET

/account/info

Chỉ đọc

Số dư ví, loại tài khoản (member/reseller/admin), quyền của khoá đang gọi, cấp đại lý + TB nạp/tháng, % chiết khấu từng mảng (thành viên = 0). KHÔNG trả khoá.

GET https://cloudmoon.net/api/v1/account/info

Không có tham số — chỉ cần header X-API-Key.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/account/info' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/account/info",
    headers={"X-API-Key": "ak_..."},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/account/info", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/account/info');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "username": "reseller_a",
        "email": "[email protected]",
        "account_type": "reseller",
        "key_scope": "ghi",
        "reseller_level": 2,
        "reseller_topup": 35000000,
        "balance": 5000000,
        "discounts": {
            "domain": 5,
            "ssl": 5,
            "hosting": 10,
            "waf": 10,
            "cloudvps": 10,
            "vpssave": 5,
            "dedi": 5,
            "key": 10,
            "mailbox": 10,
            "monitor": 0,
            "seo": 0
        }
    }
}
GET

/account/logs

Chỉ đọc

Nhật ký lượt gọi API của chính tài khoản (audit). Phân trang.

GET https://cloudmoon.net/api/v1/account/logs
Tham sốVị tríBắt buộcMô tả
limit query không số dòng (1-200, mặc định 50)
page query không trang (mặc định 1)
Yêu cầu
curl 'https://cloudmoon.net/api/v1/account/logs' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/account/logs",
    headers={"X-API-Key": "ak_..."},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/account/logs", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/account/logs');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "items": [
            {
                "method": "POST",
                "endpoint": "/api/v1/cloudvps/buy",
                "ip": "1.2.3.4",
                "http_status": 202,
                "status": "success",
                "msg": "OK",
                "created_at": "2026-06-03 10:00:00"
            }
        ],
        "page": 1,
        "limit": 50,
        "total": 1
    }
}
GET

/services/status

Chỉ đọc

Trạng thái bật/tắt (bảo trì) của từng dịch vụ. Dịch vụ đang tắt: lệnh mua mới trả code SERVICE_DISABLED (HTTP 503); gia hạn đơn cũ vẫn chạy bình thường. Hỏi định kỳ để tự ẩn nút mua của dịch vụ đang tạm dừng. cloudvps_hourly = VPS theo giờ (/cloudvps-hourly/*).

GET https://cloudmoon.net/api/v1/services/status

Không có tham số — chỉ cần header X-API-Key.

Yêu cầu
curl 'https://cloudmoon.net/api/v1/services/status' \
  -H 'X-API-Key: ak_...'
Yêu cầu
import requests

r = requests.get(
    "https://cloudmoon.net/api/v1/services/status",
    headers={"X-API-Key": "ak_..."},
    timeout=30,
)
print(r.status_code, r.json())
Yêu cầu
// Node.js 18+ — lưu thành tệp .mjs

const res = await fetch("https://cloudmoon.net/api/v1/services/status", {
  headers: { "X-API-Key": "ak_..." },
});
console.log(res.status, await res.json());
Yêu cầu
// cm_api(): xem mục "Client mẫu" ở trang Tổng quan
$kq = cm_api('GET', '/v1/services/status');
print_r($kq);
Phản hồi
{
    "status": "success",
    "msg": "OK",
    "data": {
        "services": {
            "cloudvps": true,
            "cloudvps_hourly": true,
            "dedi": true,
            "vpssave": true,
            "hosting": false,
            "waf": true,
            "key": true,
            "monitor": true,
            "domain": true,
            "ssl": true,
            "seo": true,
            "mailbox": true
        },
        "disabled": [
            "hosting"
        ]
    }
}
Zalo