LuawardDocs

คีย์จำนวนมากและการส่งออก

สร้างหรือนำเข้าคีย์ได้ถึงพันอัน จัดการทีละห้าร้อยอัน และส่งออกเป็น JSON หรือ CSV

คำขอ POST คีย์แบบ bulk รองรับ JSON สูงสุด 512 KiB; คำขอ source แบบ POST/PUT รองรับ 4 MiB และค่าเริ่มต้นของคำขออื่นคือ 16 KiB การเขียนต้องมี keys:write ส่วนการส่งออกต้องมี API key ที่ใช้งานได้และเข้าถึงโปรเจกต์นี้

สร้างคีย์จำนวนมาก

POST /v3/projects/:id/users/bulk

ส่ง count (1 ถึง 1000) เพื่อสร้างคีย์ตามจำนวนนั้น หรือ users (1 ถึง 1000) เพื่อนำเข้าคีย์ที่คุณมีอยู่แล้ว เช่นตอนย้ายจาก Luarmor เลือกอย่างใดอย่างหนึ่ง ไม่ใช่ทั้งสอง

{ "count": 200, "note": "Giveaway", "key_days": 30 }
{
  "users": [
    { "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "note": "from Luarmor", "discord_id": "123456789012345678", "auth_expire": 1893456000 }
  ]
}

กับ count ฟิลด์ note, key_days และ auth_expire ทำงานเหมือนคีย์เดี่ยว (ไม่หมดอายุเมื่อไม่ระบุวันสิ้นสุด) กับ users แต่ละรายการรับ user_key (32 ตัวอักษร) และจะมี note, discord_id, identifier, key_days หรือ auth_expire ด้วยก็ได้ คำตอบมี created และสำหรับ count มี user_keys ส่วน users มีรายการ skipped ของคีย์ที่มีอยู่แล้ว (code KEY_EXISTS) ลิมิตคีย์ของแผนตรวจภายใต้ล็อก: การเรียกที่ใส่ไม่พอจะไม่สร้างอะไรเลย (403 PLAN_LIMIT) และการเรียกที่มาพร้อมกันผ่านลิมิตไปด้วยกันไม่ได้

จัดการหลายคีย์พร้อมกัน

Routeทำอะไร
POST /v3/projects/:id/users/bulk/banแบนคีย์ (reason, until เหมือนคีย์เดี่ยว) คำตอบมีออบเจ็กต์ unban_tokens โทเคนหนึ่งอันต่อคีย์
POST /v3/projects/:id/users/bulk/unbanปลดแบน
POST /v3/projects/:id/users/bulk/resethwidปลดคีย์จากอุปกรณ์ (ใช้ reset-hwid ก็ได้) ข้าม cooldown ของโปรเจกต์ เหมือนการรีเซ็ตโดยเจ้าของ
POST /v3/projects/:id/users/bulk/deleteลบคีย์ แต่ละอันถูกบันทึกใน audit log
POST /v3/projects/:id/users/bulk/extendเพิ่ม days (1 ถึง 36500) คีย์ที่หมดอายุแล้วได้วันนับจากวันนี้ คีย์ที่ยังใช้อยู่ถูกต่อท้ายวันสิ้นสุด คีย์แบบ "นับวันจากการใช้ครั้งแรก" ที่ยังไม่ใช้ได้วันเพิ่ม ส่วนคีย์ตลอดชีพไม่ถูกแตะและอยู่ในรายการ unchanged
{ "user_keys": ["AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "ZyXwVuTsRqPoNmLkJiHgFeDcBaZyXwVu"], "days": 30 }

user_keys ใส่ได้ 1 ถึง 500 คีย์ (ซ้ำนับครั้งเดียว) คำตอบมี updated และ not_found คือคีย์ที่ไม่อยู่ในโปรเจกต์นี้ (คีย์ของโปรเจกต์หรือ workspace อื่นดูเหมือนกัน) ทุกการเปลี่ยนแปลงบันทึกในประวัติของคีย์พร้อมชื่อ API key

ส่งออกคีย์

GET /v3/projects/:id/users/export

พารามิเตอร์ความหมาย
formatjson (ค่าเริ่มต้น) หรือ csv
statusunused, active, reset หรือ banned
limitจำนวนคีย์ต่อการเรียก 1 ถึง 50000 ค่าเริ่มต้น 10000
cursornext_cursor จากการเรียกก่อนหน้า

คีย์เรียงจากเก่าไปใหม่ และหน้าต่อกันพอดีไม่ซ้ำไม่ขาด แม้คีย์ที่สร้างในเวลาเดียวกัน JSON ตอบ users, count และ next_cursor (null เมื่อเป็นหน้าสุดท้าย) CSV มีแถวหัวและคอลัมน์เหมือนคีย์ในรายการ ส่วน cursor อยู่ใน header X-Next-Cursor เซลล์ที่ขึ้นต้นด้วย =, +, - หรือ @ จะมีเครื่องหมายอัญประกาศนำหน้า เพื่อให้สเปรดชีตแสดงเป็นข้อความ ไม่ใช่สูตร