Tài liệu API Hệ Thống

Tổng Quan Về API Hệ Thống

API của hệ thống cho phép bạn tích hợp tự động hóa các dịch vụ mua bán, quản lý trên website của mình. Tất cả request đều sử dụng phương thức POST và trả về định dạng JSON.

Base URL Endpoint:

https://cloudhost.sbs/api/v1

Xác thực (Authentication)

Tất cả các API đều yêu cầu xác thực bằng auth_token. Bạn có thể truyền token bằng 1 trong 2 cách sau:

Qua Header: Authorization: Bearer {auth_token}
Qua Body Request: auth_token={auth_token}

Bạn có thể lấy auth_token tại phần Bảo mật tài khoản. Hãy giữ bí mật đoạn mã này!

Lấy thông tin tài khoản

POST /api/v1/profile

Body Parameters

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của bạn
`action`	Có	Giá trị mặc định: `profile`

Response Success

{
    "status": "success",
    "message": "Thành công",
    "data": {
        "username": "doilacloi",
        "email": "user@gmail.com",
        "money": 500000,
        "level": "member"
    }
}

Response Error

{
    "status": "error",
    "message": "Token không hợp lệ hoặc đã hết hạn"
}

API Dịch Vụ Hosting

POST /api/v1/hosting

Body Parameters (Lấy danh sách / Mua mới)

Tham số	Bắt buộc	Mô tả
`action`	Có	`list` (Lấy gói) hoặc `buy` (Mua Hosting)
`id`	Theo action	ID của gói Hosting (Bắt buộc nếu action=buy)
`domain`	Theo action	Tên miền gắn vào Hosting (Bắt buộc nếu action=buy)
`months`	Theo action	Số tháng mua (1, 3, 6, 12) (Bắt buộc nếu action=buy)

Mẫu Response khi Mua Hosting thành công

{
    "status": "success",
    "message": "Khởi tạo Hosting thành công",
    "data": {
        "domain": "mydomain.com",
        "ip": "103.xxx.xxx.xxx",
        "username": "user_host",
        "password": "random_password",
        "expired_at": "2024-12-31"
    }
}

API Lấy Danh Sách Sản Phẩm (Mã Nguồn / Dịch Vụ)

POST /api/v1/products

Body Parameters

Tham số	Bắt buộc	Mô tả
`action`	Có	`list_source` (Mã nguồn) hoặc `list_web` (Tạo web)
`limit`	Không	Số lượng kết quả trả về (Mặc định 20)

Mẫu Response danh sách

{
    "status": "success",
    "data": [
        {
            "id": 1,
            "title": "Mã nguồn Bán Hàng Pro",
            "price": 500000,
            "demo_url": "https://demo.com",
            "thumbnail": "https://img.com/a.jpg"
        }
    ]
}

API Cấu Hình Cronjob

POST /api/v1/cronjob

Body Parameters (Thêm Cronjob mới)

Tham số	Bắt buộc	Mô tả
`action`	Có	Nhập `create`
`url`	Có	Link URL cần chạy cron
`method`	Có	`GET` hoặc `POST`
`time`	Có	Chu kỳ chạy (Số giây)

{
    "status": "success",
    "message": "Thêm tiến trình cronjob thành công",
    "cron_id": 1502
}

Thông tin chung

API Dịch Vụ

Tổng Quan Về API Hệ Thống

Xác thực (Authentication)

Lấy thông tin tài khoản

Body Parameters

Response Success

Response Error

API Dịch Vụ Hosting

Body Parameters (Lấy danh sách / Mua mới)

Mẫu Response khi Mua Hosting thành công

API Lấy Danh Sách Sản Phẩm (Mã Nguồn / Dịch Vụ)

Body Parameters

Mẫu Response danh sách

API Cấu Hình Cronjob

Body Parameters (Thêm Cronjob mới)