API MUA VÀ KÍCH HOẠT TOOL TRÊN SHOP.PHANMEMGIARE.NET

Tài liệu API cho Shop Phan Mem Gia Re

1. API: Mua Tool

Mô tả: API này cho phép người dùng mua một tool trong hệ thống bằng cách cung cấp access_token, mã tool (bethen), và mã voucher (tùy chọn).

• URL: https://shop.phanmemgiare.net/apibuytool/{access_token}/{bethen}/{voucher_code}
• Phương thức: GET

Tham số

Path Parameters:

• access_token (string, bắt buộc): Token xác thực của người dùng có trong phần tài khoản.
  VD : 4CMTCEOB79T15N5IUB2BEB7MYIK806
  
  
  
  
  
• bethen (string, bắt buộc): Mã định danh của tool cần mua.
  VD : https://shop.phanmemgiare.net/tool/detail?code=4de1d9c94e41112351a7c9f0f4eeaa6e
  bethen  sẽ là  4de1d9c94e41112351a7c9f0f4eeaa6e
• voucher_code (string, tùy chọn): Mã voucher để giảm giá (nếu có).

Ví dụ URL

• Không voucher: https://shop.phanmemgiare.net/apibuytool/4CMTCEOB79T15N5IUB2BEB7MYIK806/4de1d9c94e41112351a7c9f0f4eeaa6e
• Có voucher: https://shop.phanmemgiare.net/apibuytool/4CMTCEOB79T15N5IUB2BEB7MYIK806/4de1d9c94e41112351a7c9f0f4eeaa6e/SALE20

Response

Thành công:

{
  "status": "success",
  "message": "Thanh toán thành công!",
  "transaction_code": "X7K9P2M4"
}

Lỗi:

• Thiếu thông tin: {"status": "error", "message": "Thiếu thông tin cần thiết!"}
• Token không hợp lệ: {"status": "error", "message": "Access token không hợp lệ!"}
• Tool không tồn tại: {"status": "error", "message": "Sản phẩm này không tồn tại!"}
• Voucher không hợp lệ: {"status": "error", "message": "Voucher không hợp lệ!"}
• Hết lượt voucher: {"status": "error", "message": "Voucher đã hết lượt sử dụng!"}
• Số dư không đủ: {"status": "error", "message": "Số dư không đủ, vui lòng nạp thêm!"}
• Phương thức sai: {"status": "error", "message": "Yêu cầu không hợp lệ!"}

---

2. API: Cập nhật Key Giao Dịch Tool

Mô tả: API này cho phép người dùng cập nhật key_active (mã máy) cho một giao dịch mua tool dựa trên access_token, transaction_code, và key.

• URL: https://shop.phanmemgiare.net/apiactivekey/{access_token}/{transaction_code}/{key}
• Phương thức: GET

Tham số

Path Parameters:

• access_token (string, bắt buộc): Token xác thực của người dùng.
• transaction_code (string, bắt buộc): Mã giao dịch của lần mua tool trước đó.
• key (string, bắt buộc): Mã máy (key) cần cập nhật cho giao dịch.

Ví dụ URL

• https://shop.phanmemgiare.net/apiactivekey/4CMTCEOB79T15N5IUB2BEB7MYIK806/X7K9P2M4/KEY9999

Response

Thành công:

{
  "status": "success",
  "msg": "Cập nhật key thành công!"
}

Lỗi:

• Thiếu dữ liệu: {"status": "error", "msg": "Thiếu dữ liệu!"}
• Token không hợp lệ: {"status": "error", "msg": "Access token không hợp lệ!"}
• Thiếu mã giao dịch: {"status": "error", "msg": "Thiếu mã giao dịch!"}
• Thiếu key: {"status": "error", "msg": "Vui lòng nhập mã máy!"}
• Giao dịch không tồn tại: {"status": "error", "msg": "Giao dịch này không tồn tại hoặc không thuộc về bạn!"}
• Chưa đến thời gian đổi: {"status": "error", "msg": "Lần đổi tiếp theo: 12:00:00 03/03/2025"}
• Hết hạn thuê: {"status": "error", "msg": "Thời gian thuê đã hết hạn, vui lòng gia hạn!"}
• Không có quyền: {"status": "error", "msg": "Giao dịch này bạn không có quyền thay đổi!"}

---