LuawardDocs

อ้างอิง 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/json

body เป็น 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 ที่ตรงตัว
statusunused, 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_id15 ถึง 22 หลัก
identifier8 ถึง 200 ตัวอักษร ผูก key กับอุปกรณ์ล่วงหน้า
key_days1 ถึง 36500 key ใช้ได้กี่วันนับจากการใช้ครั้งแรก
auth_expireUnix 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 ดูตารางเต็มใน ภาพรวม