Tài liệu API Toàn Tập
Chào mừng bạn đến với tài liệu API của ChengLongStore. Tại đây cung cấp hướng dẫn tích hợp cho tất cả các dịch vụ chúng tôi cung cấp.Môi trường & Base URL
Production Base URL
https://chenglongstore.com/api/v1Xác thực (Authentication)
Tất cả các API của chúng tôi đều được bảo vệ và yêu cầu xác thực bằng Access Token qua HTTP Header. Bạn có thể tạo token tại trang Tài khoản.Authorization Header
Authorization: Bearer your_access_token_hereĐịnh dạng Phản hồi (Response Format)
Tất cả các phản hồi từ API (kể cả thành công hay thất bại) đều sử dụng định dạng JSON và có một cấu trúc thống nhất:Cấu trúc chuẩn
{
"success": boolean, // Trạng thái thành công hay thất bại (true/false)
"message": string, // Thông điệp (thường xuất hiện khi có lỗi)
"data": object | array // Dữ liệu trả về (nếu success = true)
}Mã Lỗi Chung (Common HTTP Status Codes)
| HTTP Code | Mô tả | Cách xử lý chung |
|---|---|---|
| 200 OK | Thành công. | Đọc dữ liệu từ biến data. |
| 400 Bad Request | Thiếu hoặc sai dữ liệu đầu vào. | Kiểm tra lại Request Body hoặc Query Parameters. |
| 401 Unauthorized | Token không hợp lệ, bị lỗi hoặc đã bị xoá. | Lấy lại Access Token mới trong phần Cài đặt. |
| 404 Not Found | Không tìm thấy tài nguyên. | Kiểm tra lại ID hoặc endpoint. |
| 500 Internal Server | Lỗi từ máy chủ của chúng tôi. | Thử lại sau ít phút hoặc liên hệ Admin. |
Các API Khai Thác Chung (Core API)
GET
/api/v1/user/balanceLấy thông tin số dư (balance) hiện tại của tài khoản.
Example Request
cURL
curl "https://chenglongstore.com/api/v1/user/balance" \
-H "Authorization: Bearer your_access_token_here"Response
Thành công
{
"success": true,
"data": {
"balance": 250000
}
}Lỗi
{
"success": false,
"message": "Unauthorized"
}