Tài liệu tích hợp API locket.solu24h.com
Kết nối trực tiếp website bán hàng, Telegram Bot hoặc hệ thống đại lý để tra cứu Locket, kích hoạt / gia hạn gói VIP tự động 24/7 và xuất hồ sơ .mobileconfig bọc sẵn theo thương hiệu.
X-API-Key: YOUR_API_KEY # Hoặc chuẩn Bearer: Authorization: Bearer YOUR_API_KEY
API Key & Cấu hình Bảo mật Developer
Quản lý API Key, giới hạn IP server gọi API và Webhook tự động
Đăng nhập để lấy API Key cá nhân & cấu hình IP Whitelist / Webhook
Mọi tài khoản đều được cấp sẵn API Key miễn phí và tự động hưởng chiết khấu CTV / hạng thành viên khi đặt đơn qua API v1.
Danh sách mã gói (plan_code) đang mở bán
Bấm vào từng plan_code để sao chép và truyền vào POST /api/v1/locket/orders.
Danh sách Endpoints API v1 (0)
Chọn ngôn ngữ code mẫu ở góc phải để copy chạy trực tiếp hoặc bấm Thử gọi API trên các endpoint tra cứu.
Xác thực Webhook (HMAC-SHA256)
Mọi Webhook gửi từ hệ thống đều ký bằng partner_key trong header X-Webhook-Signature.
const crypto = require("crypto");
function verifyLocketWebhook(rawBody, signatureHeader, partnerKey) {
const expected =
"sha256=" +
crypto.createHmac("sha256", partnerKey).update(rawBody, "utf8").digest("hex");
return crypto.timingSafeEqual(
Buffer.from(String(signatureHeader || "")),
Buffer.from(expected)
);
}Mã trạng thái & Xử lý lỗi (HTTP Status)
Mọi response lỗi đều trả JSON chuẩn: { "status": "error", "message": "..." }
| HTTP | Mã lỗi | Ý nghĩa |
|---|
