Tài liệu Đấu nối API Tự Động Hóa
Dành cho Nhà phát triển, Bot Telegram, Web bán hàng tự động & Hệ thống Đại lý CTV.
1 Khóa API & Xác thực (Authentication)
Mỗi đối tác / CTV được cấp một cặp khóa trong Dashboard quản lý:
sk_...)
Khóa bí mật dùng cho Bot/Server để gọi các API mua hàng, check UID, quản lý phiên. Cần giữ bí mật tuyệt đối.
pk_...)
Mã định danh công khai dùng cho liên kết giới thiệu Affiliate.
// HTTP Headers chuẩn cần gửi trong mọi request:
Authorization: Bearer sk_YOUR_SECRET_KEY
Content-Type: application/json
2 Cơ chế thanh toán & Đơn vị Coin
- Hệ thống sử dụng Coin để thanh toán cho mọi đơn hàng gọi qua API.
- Tỉ lệ quy đổi cố định: 1 Coin = 1.000 VNĐ.
- Coin được trừ trực tiếp từ số dư tài khoản CTV khi gọi API mua hàng thành công.
- Nếu số dư không đủ, API sẽ trả về lỗi HTTP 402 kèm số coin còn thiếu (
missingCoin).
3 Danh sách Endpoint API v2.0
/api/v2/packages
Lấy danh sách tất cả các gói dịch vụ và đơn giá Coin hiện tại.
/api/v2/locket/uid
Tra cứu UID, tên hiển thị, ảnh đại diện và trạng thái tài khoản Locket.
// Body:
{"username": "iamvanchinh"}
/api/v2/orders
Mua gói Locket Gold hoặc Filter AI trừ trực tiếp Coin trong tài khoản.
// Body:
{"packageCode": "LKGVV", "uid": "iamvanchinh"}
/api/v2/orders/{orderCode}
Kiểm tra trạng thái đơn hàng và lấy link tải DNS Profile.
4 Code Bot Mẫu
const axios = require('axios');
async function upgradeLocket(username, packageCode = 'LKGVV') {
const res = await axios.post('https://www.muahangmmo.com/api/v2/orders', {
packageCode: packageCode,
uid: username
}, {
headers: {
'Authorization': 'Bearer sk_YOUR_SECRET_KEY',
'Content-Type': 'application/json'
}
});
console.log('Kích hoạt thành công:', res.data);
return res.data;
}
upgradeLocket('iamvanchinh');
import requests
url = "https://www.muahangmmo.com/api/v2/orders"
headers = {
"Authorization": "Bearer sk_YOUR_SECRET_KEY",
"Content-Type": "application/json"
}
payload = {
"packageCode": "LKGVV",
"uid": "iamvanchinh"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
5 Bảng Mã Lỗi (HTTP Status Codes)
| Mã HTTP | Ý nghĩa | Mô tả chi tiết |
|---|---|---|
| 200 OK | Thành công | Giao dịch được xử lý và kích hoạt thành công. |
| 400 Bad Request | Tham số không hợp lệ | Thiếu packageCode hoặc username/uid. |
| 401 Unauthorized | Sai khóa xác thực | Secret Token (sk_...) không hợp lệ hoặc đã bị khóa. |
| 402 Payment Required | Thiếu số dư Coin | Số dư Coin của tài khoản không đủ để thanh toán gói cước. |
| 404 Not Found | Không tìm thấy | Mã gói cước hoặc đơn hàng không tồn tại. |
Thử Nghiệm API Trực Tiếp (Live Tester)
InteractiveThử nghiệm gửi request tra cứu UID hoặc mua gói ngay trong trình duyệt.
// Bấm một trong các nút test ở trên để xem phản hồi...