RESTful Partner API v1.0 • Kích Hoạt Tự Động 24/7

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.

⚡ Tốc độ: ~300ms 🔒 Xác thực: Header X-API-Key 🎁 Quà tặng: 5 lượt kích hoạt miễn phí khi tạo key

🔑 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í.

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.

Base URL:
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:

X-API-Key: lkt_live_your_partner_key_here

Hoặc sử dụng chuẩn Bearer Token:

Authorization: Bearer lkt_live_your_partner_key_here
POST /api/v1/partner/activate

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" }
POST /api/v1/partner/test-trial 1 LƯỢT MIỄN PHÍ • 30 PHÚT TỰ HỦY

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" }
GET /api/v1/partner/check-uid

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.

GET /api/v1/partner/check-uid?uid=Zg8dK21Lms9124kdsm12Kds1923l

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"
  }
}
GET /api/v1/partner/info

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.

⏱️
Quy định lượt test thử nghiệm:

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ợ.