Locket
RESTful API v2.0

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.

Base URL: https://www.muahangmmo.com

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ý:

Secret Token (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.

Public Token (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

GET /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.

POST /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"}

POST /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"}

GET /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

Node.js (Axios)
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');
                        
Python (Requests)
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)

Interactive

Thử 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...