Hệ Thống API Tích Hợp
Dành Cho Đại Lý & Đối Tác
Kết nối hệ thống kích hoạt Locket Gold VIP tự động trực tiếp vào Website, Shop tự động, Bot Telegram hoặc ứng dụng của bạn. Kích hoạt VIP thành công sau dưới 1 giây chỉ với Firebase UID hoặc Link tài khoản Locket.
🔑 Quản Lý API Key Đối Tác
Sử dụng API Key cá nhân để thực hiện các yêu cầu kích hoạt từ server của bạn.
Bạn Cần Đăng Nhập Để Lấy API Key
Đăng nhập tài khoản LocketGold để tự động nhận API Key đối tác và 5 lượt kích hoạt thử nghiệm hoàn toàn miễn phí.
Hệ thống sẽ gửi yêu cầu POST HTTP với payload kết quả kích hoạt tới URL này mỗi khi có UID được kích hoạt thành công.
1. Tổng Quan & Xác Thực API
Mọi yêu cầu gửi đến API của LocketGold cần được gửi qua giao thức HTTPS. Hệ thống chấp nhận cả JSON Body lẫn form URL-encoded.
https://locketgold.lol
Header Xác Thực (Authentication):
Truyền API Key vào một trong hai Header HTTP sau trong mỗi request:
Hoặc sử dụng chuẩn Bearer Token:
Kích hoạt tài khoản Locket Gold VIP cho khách hàng. Hệ thống tự động trừ 1 lượt quota của đối tác và ghi nhận log giao dịch.
Tham Số Body (Request Body):
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| uid | string | Có | Firebase UID (28 ký tự) hoặc Link Locket (vd: https://locket.cam/u/username). Hệ thống tự giải mã UID. |
| package_name | string | Không | Tên gói kích hoạt (mặc định: "Locket Gold VIP"). |
| note | string | Không | Mã đơn hoặc ghi chú nội bộ của đối tác (vd: "Order #9872"). |
Phản Hồi Thành Công (HTTP 200 OK):
{
"ok": true,
"success": true,
"uid": "Zg8dK21Lms9124kdsm12Kds1923l",
"status": "activated",
"package_name": "Locket Gold VIP",
"partner": "Partner_demo",
"remaining_quota": 4,
"activated_at": "2026-10-11 18:30:00"
}
Phản Hồi Lỗi (Error Codes):
// 401 Unauthorized: API Key không chính xác
{ "ok": false, "error": "Invalid or inactive API key", "code": "UNAUTHORIZED" }
// 402 Payment Required: Đã dùng hết hạn mức kích hoạt
{ "ok": false, "error": "Quota exhausted. Vui lòng liên hệ Admin nạp thêm lượt kích hoạt.", "code": "QUOTA_EXCEEDED" }
// 400 Bad Request: UID không hợp lệ
{ "ok": false, "error": "UID không hợp lệ", "code": "INVALID_UID" }
Cấp 1 lượt test dùng thử Locket Gold VIP trong 30 phút để đối tác kiểm thử tích hợp.
⚠️ Lưu ý quan trọng: Sau đúng 30 phút kể từ lúc kích hoạt, hệ thống sẽ tự động xóa hoàn toàn UID khỏi server. Mỗi đối tác hoặc IP chỉ được cấp 1 lượt test duy nhất.
Tham Số Body (Request Body):
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| uid | string | Có | Firebase UID hoặc Link Locket (vd: https://locket.cam/u/username). |
| api_key | string | Không | API Key của đối tác (nếu có, hoặc gửi qua Header X-API-Key). |
Phản Hồi Thành Công (HTTP 200 OK):
{
"ok": true,
"success": true,
"is_trial": true,
"uid": "Zg8dK21Lms9124kdsm12Kds1923l",
"status": "activated",
"duration_minutes": 30,
"package_name": "Locket Gold VIP (Test 30P)",
"activated_at": "2026-10-11 19:30:00",
"expires_at": "2026-10-11 20:00:00",
"message": "Kích hoạt test 30 phút thành công! Sau 30 phút UID sẽ tự động xóa khỏi server."
}
Phản Hồi Lỗi (Error Codes):
// 409 Conflict: Đã sử dụng hết lượt dùng thử 30 phút
{ "ok": false, "error": "Bạn hoặc UID này đã sử dụng hết 1 lượt test 30 phút miễn phí.", "code": "TRIAL_ALREADY_USED" }
Kiểm tra xem một Firebase UID hoặc Link Locket đã được kích hoạt VIP trên hệ thống Locket Gold hay chưa.
Phản hồi mẫu:
{
"ok": true,
"uid": "Zg8dK21Lms9124kdsm12Kds1923l",
"is_active": true,
"details": {
"package_name": "Locket Gold VIP",
"status": "active",
"activated_at": "2026-10-11 18:30:00"
}
}
Lấy số dư lượt kích hoạt còn lại (balance_quota) và số lượt đã dùng của tài khoản đối tác.
Phản hồi mẫu:
{
"ok": true,
"name": "Partner_demo",
"balance_quota": 45,
"used_quota": 5,
"is_active": 1
}
5. Mẫu Code Tích Hợp Đa Ngôn Ngữ
Chọn ngôn ngữ lập trình của bạn để sao chép đoạn mã tích hợp sẵn:
curl -X POST https://locketgold.lol/api/v1/partner/activate \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY_HERE" \
-d '{
"uid": "https://locket.cam/u/username",
"package_name": "Locket Gold VIP",
"note": "Don hang #12345"
}'
🧪 Thử Nghiệm API Trực Tiếp (Sandbox)
Nhập UID hoặc Link Locket của khách hàng để thử nghiệm kích hoạt trực tiếp từ trình duyệt.
Mỗi tài khoản đối tác hoặc địa chỉ IP được tặng 1 lượt test thời gian hoạt động 30 phút. Hết đúng 30 phút, hệ thống tự động xóa hoàn toàn UID khỏi máy chủ.
7. Bảng Mã Lỗi & HTTP Status Codes
| Status | Code String | Ý nghĩa & Hướng xử lý |
|---|---|---|
| 200 OK | SUCCESS | Kích hoạt thành công, UID được cấp quyền VIP và quota trừ 1. |
| 401 Unauthorized | UNAUTHORIZED | API Key không đúng hoặc đã bị khóa. Vui lòng kiểm tra lại Header. |
| 402 Payment Required | QUOTA_EXCEEDED | Tài khoản hết hạn mức kích hoạt. Vui lòng liên hệ Admin nạp thêm. |
| 400 Bad Request | INVALID_UID | Định dạng UID hoặc Link không phân giải được. |
| 500 Server Error | INTERNAL_ERROR | Lỗi hệ thống máy chủ, liên hệ kỹ thuật để được hỗ trợ. |