Tài Liệu Tích Hợp API
Hướng dẫn tích hợp hệ thống đại lý & website vệ tinh với SellToolMMO.Com. Tài liệu được sắp xếp theo đúng quy trình từ lấy danh mục sản phẩm, đặt hàng, kích hoạt bản quyền key đến quản lý đơn hàng.
Lưu ý quan trọng: Để sử dụng các API tạo đơn và kích hoạt key, bạn cần liên hệ admin để nhận Access Token và mã Voucher chiết khấu đại lý. Nếu muốn tạo website đại lý tự động, vui lòng liên hệ Zalo Admin để được hỗ trợ source code miễn phí.
Quy Trình Tích Hợp (4 Bước Liền Mạch)
Để hoàn tất việc bán tool trên website của bạn, hãy triển khai các API theo thứ tự tuần tự từ Bước 1 đến Bước 4 dưới đây:
1. Lấy Danh Sách Sản Phẩm
Gọi API để lấy toàn bộ danh mục tool, giá (ngày, năm, vĩnh viễn), ảnh và mã code để hiển thị lên shop.
2. Đặt Mua & Tạo Đơn
Khách hàng bấm mua, website gửi request kèm mã tool để tạo đơn và nhận về transaction_code.
3. Kích Hoạt Key Máy
Khách mở phần mềm lấy mã máy (HWID), gửi kèm transaction_code để kích hoạt bản quyền.
4. Quản Lý / Xoá Đơn
API dự phòng hỗ trợ xóa đơn hàng hoặc xử lý hoàn hủy đơn theo transaction_code khi cần thiết.
Chuẩn Xác Thực (Authentication)
Các API thực hiện thao tác bảo mật (như Đặt mua order.php và Kích hoạt key active_key.php) yêu cầu truyền Access Token qua HTTP Header theo chuẩn Bearer:
Authorization: Bearer YOUR_ACCESS_TOKEN Content-Type: application/json
Bước 1: API Lấy Danh Sách / Chi Tiết Tool
Dùng để đồng bộ danh sách sản phẩm, bảng giá và thông tin phần mềm về website đại lý hoặc tra cứu thông tin chi tiết một tool cụ thể qua mã code.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
code |
string | Tùy chọn | Mã định danh tool (VD: TOOL001). Nếu truyền thì trả về chi tiết 1 tool; nếu không truyền thì trả về toàn bộ danh sách. |
GET https://www.selltoolmmo.com/api/apilisttool.php
GET https://www.selltoolmmo.com/api/apilisttool.php?code=TOOL001
{
"success": true,
"total": 2,
"data": [
{
"id": "1",
"code": "TOOL001",
"title": "Phần mềm Nuôi Nick Facebook Tự Động",
"image": "https://example.com/uploads/tool1.png",
"price": "10000",
"price_yearly": "500000",
"price_vinh_vien": "1500000",
"price_vinh_vien_usd": "70",
"version": "1.0.0",
"status": "1"
},
{
"id": "2",
"code": "TOOL002",
"title": "Phần mềm Quét Data Khách Hàng Tiềm Năng",
"image": "https://example.com/uploads/tool2.png",
"price": "15000",
"price_yearly": "700000",
"price_vinh_vien": "2000000",
"price_vinh_vien_usd": "90",
"version": "2.1.0",
"status": "1"
}
]
}
{
"success": true,
"data": {
"id": "1",
"code": "TOOL001",
"title": "Phần mềm Nuôi Nick Facebook Tự Động",
"image": "https://example.com/uploads/tool1.png",
"price": "10000",
"price_yearly": "500000",
"price_vinh_vien": "1500000",
"price_vinh_vien_usd": "70",
"version": "1.0.0",
"status": "1"
}
}
Bước 2: API Đặt Mua & Đồng Bộ Đơn Hàng
Khi người dùng trên website đại lý thanh toán mua tool, gọi API này để hệ thống trừ số dư đại lý, khởi tạo đơn hàng và trả về transaction_code (Mã giao dịch).
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
buy_type |
string | ✓ Bắt buộc | Loại mua: vinh_vien hoặc thue |
product_type |
string | ✓ Bắt buộc | Loại sản phẩm: tool hoặc source |
bithen |
string | ✓ Bắt buộc | Mã code của sản phẩm cần mua (VD: TOOL001) |
website |
string | ✓ Bắt buộc | Tên miền website đại lý (VD: selltoolmmo.com) |
voucher |
string | Tùy chọn | Mã voucher chiết khấu do admin cấp nếu có |
{
"buy_type": "vinh_vien",
"product_type": "tool",
"bithen": "TOOL001",
"website": "selltoolmmo.com",
"voucher": "DISCOUNT2026"
}
{
"status": "success",
"message": "Order synced successfully.",
"data": {
"transaction_code": "NWF5S0I3"
}
}
Bước 3: API Kích Hoạt Key Máy
Sau khi đã có transaction_code từ Bước 2, người dùng mở tool để lấy mã máy (HWID). Website gửi request này để liên kết bản quyền máy với đơn hàng.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
transaction_code |
string | ✓ Bắt buộc | Mã giao dịch nhận được từ API Đặt mua (Bước 2) |
key |
string | ✓ Bắt buộc | Mã máy (HWID) của khách hàng cần kích hoạt |
{
"transaction_code": "NWF5S0I3",
"key": "ABCD-1234-EFGH-5678"
}
{
"status": "success",
"message": "Active key successfully.",
"data": {
"transaction_code": "NWF5S0I3",
"key": "ABCD-1234-EFGH-5678",
"mode": "single",
"synced_phanmemgiare": false
}
}
Bước 4: API Xoá / Hủy Đơn Hàng
API này dùng để xóa dữ liệu đơn hàng khỏi hệ thống theo transaction_code khi phát sinh lỗi thanh toán hoặc khách hàng hủy đơn.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
transaction_code |
string | ✓ Bắt buộc | Mã giao dịch cần xoá khỏi cơ sở dữ liệu |
{
"transaction_code": "NWF5S0I3"
}
{
"status": "success",
"message": "Delete order successfully.",
"transaction_code": "NWF5S0I3"
}
Bảng Mã Lỗi & HTTP Status Code
Tổng hợp các HTTP Status Code và thông báo lỗi phản hồi chuẩn giúp bạn xử lý ngoại lệ dễ dàng trong quá trình phát triển ứng dụng:
| HTTP Code | Trạng thái | Ý nghĩa & Hướng xử lý |
|---|---|---|
200 OK |
Thành công | Yêu cầu đã được thực thi và trả về dữ liệu thành công. |
400 Bad Request |
Dữ liệu không hợp lệ | Thiếu tham số bắt buộc, sai định dạng JSON, số dư không đủ hoặc voucher hết lượt sử dụng. |
401 Unauthorized |
Chưa xác thực | Thiếu Access Token hoặc Access Token không chính xác trong Authorization Header. |
404 Not Found |
Không tìm thấy | Không tìm thấy mã giao dịch (transaction_code) hoặc sản phẩm không tồn tại. |
405 Method Not Allowed |
Sai phương thức | Sử dụng sai HTTP Method (Ví dụ: gửi GET thay vì POST). |
500 Server Error |
Lỗi máy chủ | Lỗi truy vấn cơ sở dữ liệu hoặc hệ thống backend. |