API & MCP cho nhà bán lại (white-label)

Luồng điển hình

Tạo một gói, thêm một khách hàng, đặt một VM cho họ; giao quyền truy cập từ thương hiệu của riêng bạn.

// Reseller token (rk_...) from the Partners cabinet -> Authorization: Bearer rk_...
// One MCP endpoint, role-filtered: a reseller token exposes the 30 reseller_* tools.
reseller_create_plan({ name, cores, ram_gb, disk_gb, ipv4, location, markup })
reseller_add_client({ email }) -> { client_id }
reseller_order_for_client({ plan_id, client_id, os_id? })   // os_id: see list_plans catalog
reseller_vm_details({ service_id }) -> { access, password }  // deliver to your client

os_id là tùy chọn — bỏ qua để dùng OS mặc định của địa điểm. Với một OS cụ thể, hãy dùng một os_id từ catalog list_plans công khai; nó sẽ phân giải sang image phù hợp cho từng địa điểm.

Hệ điều hành & os_id

Có 14 image Linux (bên dưới). Truyền os_id trong reseller_order_for_client — lấy nó từ catalog list_plans công khai. Lưu ý: available_os có thể liệt kê các id khác nhau theo địa điểm; os_id từ list_plans sẽ phân giải sang image đúng cho địa điểm của gói. Bỏ qua os_id để dùng OS mặc định của địa điểm.

Trạng thái VM

active — đang chạy. provisioning — đang được tạo (cửa sổ bất đồng bộ ngắn ngay sau khi đặt). suspended — tạm dừng (ví dụ bạn đã tạm ngưng khách hàng, hoặc chưa thanh toán); kích hoạt lại bằng reseller_unsuspend_client. cancelled — đã chấm dứt (VM bị gỡ bỏ).