คีย์จำนวนมากและการส่งออก
สร้างหรือนำเข้าคีย์ได้ถึงพันอัน จัดการทีละห้าร้อยอัน และส่งออกเป็น 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
| พารามิเตอร์ | ความหมาย |
|---|---|
| format | json (ค่าเริ่มต้น) หรือ csv |
| status | unused, active, reset หรือ banned |
| limit | จำนวนคีย์ต่อการเรียก 1 ถึง 50000 ค่าเริ่มต้น 10000 |
| cursor | next_cursor จากการเรียกก่อนหน้า |
คีย์เรียงจากเก่าไปใหม่ และหน้าต่อกันพอดีไม่ซ้ำไม่ขาด แม้คีย์ที่สร้างในเวลาเดียวกัน JSON ตอบ users, count และ next_cursor (null เมื่อเป็นหน้าสุดท้าย) CSV มีแถวหัวและคอลัมน์เหมือนคีย์ในรายการ ส่วน cursor อยู่ใน header X-Next-Cursor เซลล์ที่ขึ้นต้นด้วย =, +, - หรือ @ จะมีเครื่องหมายอัญประกาศนำหน้า เพื่อให้สเปรดชีตแสดงเป็นข้อความ ไม่ใช่สูตร