API Key Do Hệ Thống Cấp Riêng Cho Từng Tài Khoản. Vào Thông Tin Tài Khoản Để Xem Và Sao Chép. Không Cần Đăng Nhập Khi Gọi API.

Cách Gửi API Key (Chọn 1)

1. Header (Khuyến Nghị)

X-API-Key: e10adc3949ba59abbe56e057f20f883e

2. Query String

?api_key=e10adc3949ba59abbe56e057f20f883e

3. Body JSON (Cho POST)

{"api_key": "e10adc3949ba59abbe56e057f20f883e"}

Lưu Ý Quan Trọng

  • •Không Đưa API Key Ra Trình Duyệt. Lưu Ở Phía Server, Tuyệt Đối Không Hard-code Vào JavaScript/HTML.
  • •Luôn Gửi Qua HTTPS. API Key Là Thông Tin Bí Mật.
  • •Kẻ Xấu Có API Key Là Tiêu Được Số Dư Của Bạn.

Thành Công

                {
                "success": true,
                "message": "Lấy Số Dư Thành Công!",
                "data": { }
                }
                

Thất Bại

                {
                "success": false,
                "message": "API Key Không Hợp Lệ...",
                "data": null
                }
                
Trường Kiểu Mô Tả
success boolean true = Thành Công, false = Lỗi
message string Thông Báo Tiếng Việt Để Hiển Thị Cho Người Dùng
data object / null Dữ Liệu Chi Tiết, Null Khi Lỗi
STT Tên API Method Endpoint Mô Tả
1 Lấy Số Dư GET balance Lấy Số Dư Hiện Tại Của Tài Khoản.
2 Lấy Giá Dịch Vụ GET services Lấy Danh Sách Gói Dịch Vụ. Giá Trả Về Đã Được Tính Sẵn Theo Role Của Tài Khoản.
3 Mua Dịch Vụ POST order Đặt Gói Dịch Vụ Bằng Mã Mời (Friend Code). Tự Động Trừ Số Dư.
4 Lịch Sử Mua Hàng GET orders Lấy Danh Sách Đơn Hàng Đã Đặt Của Tài Khoản, Mới Nhất Trước.
5 Chi Tiết Đơn Hàng GET order-detail Lấy Chi Tiết 1 Đơn Hàng Theo ID, Kèm Tiến Độ Xử Lý.
GET

Lấy Số Dư

GET

Lấy Giá Dịch Vụ

POST

Mua Dịch Vụ

GET

Lịch Sử Mua Hàng

GET

Chi Tiết Đơn Hàng

Mã Ý Nghĩa Xử Lý
200 Thành Công -
400 Sai Tham Số Đầu Vào Kiểm Tra Lại Tham Số Gửi Lên
401 API Key Sai / Tài Khoản Bị Khóa Kiểm Tra Lại API Key Trong Thông Tin Tài Khoản
404 Không Tìm Thấy Đơn Hàng Kiểm Tra Lại ID Đơn Hàng
405 Sai Phương Thức HTTP Đọc Mỗi Endpoint Dùng GET Hay POST
409 Số Dư Không Đủ (Đã Bị Xử Lý Bởi Request Khác) Tải Lại Số Dư Và Thử Lại
429 Gọi Quá Nhanh, Bị Giới Hạn Chờ Vài Giây Rồi Thử Lại
500 Lỗi Hệ Thống Thử Lại Sau, Nếu Vẫn Lỗi Liên Hệ Chúng Tôi

Checklist Bảo Mật

  • •Không Đưa API Key Ra Trình Duyệt, Lưu Ở Phía Server.
  • •Luôn Gửi Qua HTTPS.
  • •Ghi Log Mỗi Lần Đặt Hàng Để Đối Chiếu Khi Có Khiếu Nại.
  • •Nếu Request Bị Timeout, Gọi API orders Kiểm Tra Đơn Đã Tạo Chưa Trước Khi Thử Lại.
  • •Nếu Nghi Ngờ Bị Lạm Dụng, Liên Hệ Chúng Tôi Để Giới Hạn Theo IP Whitelist.