1. Tổng Quan & Base URL
Hệ thống cung cấp REST API cho phép đối tác, shop MMO, developer tích hợp mua tài khoản tự động, kiểm tra số dư và tra cứu tồn kho live.
Base URL:
https://mmo-shop-api.khotaikhoanso-net.workers.dev
2. Xác Thực (Authentication)
Mỗi đối tác được cấp một chuỗi apiKey bí mật. Bạn có thể truyền qua Header Authorization hoặc trong JSON Body:
// Truyền trong Header:
Authorization: Bearer YOUR_API_KEY
// Hoặc truyền trong Body JSON:
{ "apiKey": "YOUR_API_KEY", ... }
3. Kiểm Tra Số Dư Ví (Get Balance)
GET
/api/user/balance?apiKey=YOUR_API_KEY
Phản hồi mẫu (JSON 200 OK):
{
"status": "success",
"email": "khachhang@gmail.com",
"balance": 500000,
"currency": "VND"
}
4. Tra Cứu Sản Phẩm & Tồn Kho Live
GET
/api/products
Phản hồi mẫu (JSON 200 OK):
{
"status": "success",
"products": [
{
"id": "PROD_MU5PWT7PP7",
"name": "TÀI KHOẢN KLING AI 65 CREDIT",
"price": 25000,
"stock": 299,
"category": "Tài khoản AI"
}
]
}
5. Mua Hàng & Nhận Tài Khoản Tức Thì (Checkout)
POST
/api/orders/checkout
Request Body (JSON):
{
"apiKey": "YOUR_API_KEY",
"productId": "PROD_MU5PWT7PP7",
"variantIndex": 0,
"quantity": 1
}
Phản hồi Thành Công (JSON 200 OK):
{
"status": "success",
"orderId": "ORD_1726891234",
"productId": "PROD_MU5PWT7PP7",
"quantity": 1,
"total": 25000,
"accounts": [
"kling_user@gmail.com|MatKhau123|2FA_SECRET"
],
"remainingBalance": 475000
}
6. Code Mẫu Thực Chiến (Copy & Chạy Ngay)
Python:
import requests
res = requests.post("https://mmo-shop-api.khotaikhoanso-net.workers.dev/api/orders/checkout", json={
"apiKey": "YOUR_API_KEY",
"productId": "PROD_MU5PWT7PP7",
"variantIndex": 0,
"quantity": 1
})
print(res.json())
Node.js / JavaScript:
fetch("https://mmo-shop-api.khotaikhoanso-net.workers.dev/api/orders/checkout", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
apiKey: "YOUR_API_KEY",
productId: "PROD_MU5PWT7PP7",
variantIndex: 0,
quantity: 1
})
}).then(r => r.json()).then(console.log);
7. Bảng Mã Phản Hồi
200 OK: Đặt mua thành công, tài khoản trả về ngay trong accounts.
400 Bad Request: Thiếu thông tin hoặc số lượng không hợp lệ.
401 Unauthorized: API Key không hợp lệ hoặc tài khoản bị khóa.
402 Payment Required: Số dư ví không đủ để thanh toán.
404 Not Found: Không tìm thấy sản phẩm yêu cầu.
409 Conflict: Sản phẩm đã hết hàng trong kho.
![](data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg"/%3E)
