อ้างอิง API v3
endpoint ปัจจุบันสำหรับข้อมูล workspace, โปรเจกต์, สถิติ และการจัดการ license key
route ที่ต้องยืนยันตัวตนใช้ developer API key ของ workspace โดยจำกัดตาม scope, โปรเจกต์ และ IP ที่อนุญาต แทน PROJECT_ID ด้วย id โปรเจกต์ที่มีสิทธิ์จาก Dashboard หรือ GET /v3/projects คีย์ลิขสิทธิ์เป็นตัวอักษร ASCII 32 ตัว (A–Z, a–z)
Authorization: Bearer YOUR_DEVELOPER_API_KEY
Content-Type: application/jsonbody เป็น JSON: ค่าเริ่มต้น 16 KiB, source ของสคริปต์ 4 MiB และ POST คีย์แบบ bulk 512 KiB ฟิลด์ผิดได้ 400 INVALID_FIELD พร้อม details ดูภาพรวมสำหรับลิมิตและ error
ตรวจสถานะสาธารณะ
GET /v3/status
ไม่ต้องยืนยันตัวตน
curl "https://api.luaward.com/v3/status"Response มี success, status, time (Unix seconds) และ version ของ API
ข้อมูลและสถิติของ workspace
GET /v3/keys/:key/details
ต้องยืนยันตัวตน คืนค่า plan ของ workspace, rate_limit ของ key และ projects: ทุกโปรเจกต์ที่ยังอยู่ พร้อม project_id, project_name, reset_hwid_allowed, reset_hwid_cooldown_days (จำนวนวันที่ผู้เล่นต้องรอระหว่างรีเซ็ตอุปกรณ์ของตัวเอง การรีเซ็ตผ่าน API ไม่ถูกจำกัด), auto_delete_expired, allow_cloned_hwid, total_users, created_at และ scripts ของมัน (script_id, script_name, enabled, ffa) ส่วน :key เป็นตัวแทนที่ไม่เคยถูกอ่าน เขียนคำอะไรก็ได้ เช่น me และห้ามใส่ API key ตรงนั้น เพราะ URL ถูกบันทึกใน log
GET /v3/keys/:key/stats
ต้องยืนยันตัวตน คืนยอดรวมทั้ง workspace: total_projects, total_users, active_users และ total_executions ไม่ใช่รายงานของ license key ตัวเดียว ยังคืน limits ของโปรเจกต์ สคริปต์ และคีย์ ว่าใช้ไปเท่าไร (used) และแผนอนุญาตเท่าไร (max) ใส่ ?noUsers=true เพื่อตัดจำนวนผู้ใช้และตัวเลขคีย์ออก (เร็วขึ้นใน workspace ที่มีคีย์มากๆ)
โปรเจกต์
โปรเจกต์รวมสคริปต์และ license key ที่ใช้เปิดสคริปต์เหล่านั้นไว้ด้วยกัน การสร้าง เปลี่ยนชื่อ และลบโปรเจกต์ใช้กติกาเดียวกับ dashboard รวมถึงลิมิตโปรเจกต์ของแผน
GET /v3/projects
คืน projects: ออบเจ็กต์ชุดเดียวกับในคำตอบ details เรียงจากเก่าไปใหม่
GET /v3/projects/:id
คืน project หนึ่งอัน โปรเจกต์ที่ไม่ได้อยู่ใน workspace ของคุณ ถูกลบแล้ว หรือไม่มีอยู่ ตอบ 404 พร้อม code PROJECT_NOT_FOUND
POST /v3/projects
{
"name": "My new project",
"reset_hwid_allowed": true,
"reset_hwid_cooldown_days": 7
}| ฟิลด์ | กติกา |
|---|---|
| name | จำเป็น 1 ถึง 60 ตัวอักษร |
| reset_hwid_allowed | ไม่บังคับ ผู้เล่นรีเซ็ตอุปกรณ์ของตัวเองได้หรือไม่ |
| reset_hwid_cooldown_days | ไม่บังคับ 0 ถึง 365 |
| auto_delete_expired | ไม่บังคับ ลบ key ที่หมดอายุอัตโนมัติ |
| allow_cloned_hwid | ไม่บังคับ ให้ key เดียวรันบนหลายเครื่องที่ใช้ device id เดียวกัน |
สำเร็จได้ 201 และ project ใหม่ webhook และรายการ "รับ key จากโปรเจกต์อื่นด้วย" ตั้งใน dashboard ปฏิเสธ: 403 PLAN_LIMIT เมื่อ workspace ถึงลิมิตโปรเจกต์
curl -X POST "https://api.luaward.com/v3/projects" \
-H "Authorization: Bearer YOUR_DEVELOPER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"My new project"}'PATCH /v3/projects/:id
ฟิลด์ใดก็ได้ข้างบน ต้องมีอย่างน้อยหนึ่งฟิลด์ ฟิลด์ที่ไม่ส่งจะคงค่าเดิม คืน project ที่อัปเดตแล้ว
DELETE /v3/projects/:id
{ "confirm_name": "My new project" }การลบต้องส่งชื่อโปรเจกต์ที่ตรงเป๊ะใน confirm_name เพื่อให้ id ที่ผิดไม่ลบผิดโปรเจกต์ (ไม่ตรงได้ 400 CONFIRM_REQUIRED) เหมือนใน dashboard โปรเจกต์และสคริปต์ของมันจะหยุดทำงานทันทีและหายไปจากรายการ สำเร็จได้ Project deleted successfully
รายการ license key
GET /v3/projects/:id/users
query parameter ที่เลือกใช้ได้:
| Parameter | ความหมาย |
|---|---|
| page | เลขหน้า 1 ถึง 100000 ค่าเริ่มต้น 1 |
| limit | ผลลัพธ์ต่อหน้า 1 ถึง 100 ค่าเริ่มต้น 50 |
| from | จุดเริ่มของช่วงผู้ใช้ นับจากใหม่สุด (0 ขึ้นไป) ถ้าใส่ จะใช้แทน page และ limit |
| until | จุดสิ้นสุดของช่วงนั้น ต้องมากกว่า from ไม่เกิน 100 ค่าเริ่มต้น from + 50 |
| search | ไม่เกิน 80 ตัวอักษร ค้นใน key, note, Discord id และ identifier โดย % และ _ เป็นตัวอักษรธรรมดา |
| user_key | กรองตาม license key ที่ตรงตัว (32 ตัวอักษร) |
| discord_id | กรองตาม Discord id ที่ตรงตัว (15 ถึง 22 หลัก) |
| identifier | กรองตาม device identifier ที่ตรงตัว |
| status | unused, active, reset หรือ banned |
ค่าที่ผิดกติกาจะได้ 400 ส่วน parameter ที่ว่างจะถูกข้าม Response มี users, total, page และ limit แต่ละ user มี user_key, identifier, identifier_type, discord_id, note, auth_expire, key_days, status, banned, ban_reason, total_resets, total_executions, created_at และ last_executed_at ถ้าใช้ช่วง Response จะมี from และ until แทน page และ limit
สร้าง license key
POST /v3/projects/:id/users
{
"note": "Customer order 492",
"discord_id": "123456789012345678",
"key_days": 30
}| ฟิลด์ | กติกา |
|---|---|
| user_key | ไม่บังคับ ต้องมี 32 ตัวอักษรพอดี ถ้าไม่ใส่ Luaward สร้างให้ |
| note | ไม่เกิน 200 ตัวอักษร |
| discord_id | 15 ถึง 22 หลัก |
| identifier | 8 ถึง 200 ตัวอักษร ผูก key กับอุปกรณ์ล่วงหน้า |
| key_days | 1 ถึง 36500 key ใช้ได้กี่วันนับจากการใช้ครั้งแรก |
| auth_expire | Unix seconds (ไม่เกินปี 2100) ที่ key หมดอายุ หรือ -1 ถ้าไม่หมดอายุ ถ้าใส่ จะไม่สนใจ key_days |
ถ้าไม่ส่งทั้ง key_days และ auth_expire คีย์จะไม่มีวันหมดอายุ คำตอบสำเร็จมี user_key, key_days, auth_expire และ created_at และยังอ่าน license key คืนได้ผ่าน users endpoint ที่ยืนยันตัวตนแล้ว ไม่ใช่แสดงครั้งเดียว ส่วน developer API key เป็นคนละ credential ที่แสดงเฉพาะตอนสร้าง
curl -X POST "https://api.luaward.com/v3/projects/PROJECT_ID/users" \
-H "Authorization: Bearer YOUR_DEVELOPER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"note":"Customer order 492","key_days":30}'ที่ปฏิเสธ: 403 PLAN_LIMIT เมื่อ workspace ถึงลิมิต key, 409 KEY_EXISTS เมื่อมี key นี้อยู่แล้ว
แก้ไข key
PATCH /v3/projects/:id/users
body ต้องมี user_key และอย่างน้อยหนึ่งใน note (ข้อความ หรือ null เพื่อล้าง), discord_id (ตัวเลข หรือ null เพื่อล้าง) และ auth_expire (ตามข้างบน และมันแทนที่ key_days) รับ identifier ด้วย: 8 ถึง 200 ตัวอักษรเพื่อผูกคีย์กับอุปกรณ์ หรือ null เพื่อปลดการผูก
{
"user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf",
"note": "Renewed",
"auth_expire": -1
}ลบ key
DELETE /v3/projects/:id/users
ส่ง user_key ใน JSON body หรือเป็น query parameter แบบที่ Luarmor ทำ (การใช้ body ทำให้ key ไม่ไปอยู่ใน URL) เมื่อสำเร็จจะได้ User deleted successfully การลบถูกบันทึกใน audit log ของ workspace
Reset device binding
POST /v3/projects/:id/users/reset-hwid
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf" }เมื่อสำเร็จจะได้ HWID reset successfully การรันที่ถูกต้องครั้งถัดไปจะผูก key กับอุปกรณ์ใหม่ได้ เหมือนการรีเซ็ตของเจ้าของใน dashboard มันไม่สนใจ cooldown ของโปรเจกต์ ใช้ชื่อแบบ Luarmor POST /v3/projects/:id/users/resethwid ได้เช่นกัน รับ force แต่ไม่มีผล เพราะการรีเซ็ตที่นี่ข้าม cooldown เสมอ
ผูกบัญชี Discord
POST /v3/projects/:id/users/linkdiscord
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "discord_id": "123456789012345678" }discord_id คือตัวเลข 15 ถึง 22 หลัก คีย์ที่ผูกกับบัญชีอื่นอยู่แล้วจะไม่ถูกแตะและตอบ 409 ALREADY_LINKED เว้นแต่ส่ง "force": true ผูกบัญชีเดิมซ้ำสำเร็จ ผลเท่ากับตั้ง discord_id ด้วย PATCH แต่มีการป้องกันนี้
Ban และ unban
POST /v3/projects/:id/users/ban
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "reason": "Refunded order", "until": 1893456000 }reason ไม่เกิน 200 ตัวอักษร until คือเวลา Unix ที่การแบนสิ้นสุด ไม่ใส่คือแบนถาวร การแบนใหม่จะแทนที่วันสิ้นสุดของการแบนก่อนหน้า Response มี unban_token (32 ตัวอักษร) ที่ลิงก์ unban ของ loader รับได้ หากต้องการ unban ผ่าน API ให้เรียก POST /v3/projects/:id/users/unban พร้อม body ที่มี user_key มันล้างเหตุผล วันสิ้นสุด และ token ใช้ route แบบ Luarmor POST /v3/projects/:id/users/blacklist และชื่อฟิลด์ ban_reason กับ ban_expire (-1 คือถาวร) ได้เช่นกัน ถ้าส่งทั้งสองแบบ ใช้ชื่อของเรา ผู้ถือ token ยังปลดแบนได้โดยไม่ต้องมี API key ด้วย GET /v3/projects/:id/users/unban?unban_token=TOKEN ใช้ได้ครั้งเดียว เฉพาะในโปรเจกต์นั้น และจำกัด 10 ครั้งต่อนาทีต่อที่อยู่
Error ที่พบบ่อย
Error จะมี success: false, ข้อความ error และ code 400 คือ body หรือฟิลด์ผิดกติกา, 401 ไม่มี key, key ผิด หรือถูกเพิกถอน, 403 ที่อยู่ไม่อยู่ในรายการ, บัญชีถูกระงับ หรือถึงลิมิต key หรือโปรเจกต์ของแผน, 404 ไม่พบโปรเจกต์หรือ key, 409 key ซ้ำ, 413 body เกิน 16 KB และ 429 ถึง rate limit ดูตารางเต็มใน ภาพรวม