LuawardDocs

API ระบบรับคีย์

อ่านและแก้หน้ารับคีย์ฟรีของโปรเจกต์: การตั้งค่า ด่าน ยอดผู้ใช้ การเข้าชม และบัญชีที่ถูกบล็อก

หน้ารับคีย์ฟรีของโปรเจกต์ (key.luaward.com/getkey/…) แจกคีย์ที่มีเวลาจำกัดหลังผู้เข้าชมทำตามด่านที่คุณตั้ง route เหล่านี้อ่านหน้านั้นและแก้ส่วนที่ปลอดภัยจะแก้จากโปรแกรม การแก้ต้องใช้คีย์ที่มี scope keysystem:write (สิทธิ์เต็มรูปแบบมีให้) ถ้าจะสร้างคีย์ชั่วคราวเอง ให้สร้างคีย์ปกติพร้อม key_days

อ่านข้อมูล

GET /v3/projects/:id/key-systems

คืน key_systems ส่วน GET …/key-systems/:key_system_id คืนหนึ่งอันพร้อม steps เรียงตามลำดับ ระบบรับคีย์มี key_system_id, name, slug, page_url, project_id, script_id (สคริปต์ที่หน้านั้นแสดง loadstring), enabled, key_hours, max_keys_per_visitor, allow_extending, allow_forgetting, require_discord, block_vpn, blocked_countries, session_timeout_seconds, enforce_ip_match, steps, created_at และ updated_at ด่านมี step_id, position, title, provider, target_url, required_seconds และ active อันที่ไม่อยู่ในโปรเจกต์นี้ตอบ 404 KEY_SYSTEM_NOT_FOUND

แก้การตั้งค่า

PATCH /v3/projects/:id/key-systems/:key_system_id

ฟิลด์กติกา
name1 ถึง 80 ตัวอักษร
enabled, allow_extending, allow_forgetting, require_discord, block_vpn, enforce_ip_matchtrue หรือ false
key_hoursอายุของคีย์: 0.25 ถึง 8760 ชั่วโมง
max_keys_per_visitor1 ถึง 20
blocked_countriesไม่เกิน 250 รหัสสองตัวอักษรตัวพิมพ์ใหญ่ เช่น RU
session_timeout_seconds300 ถึง 86400
script_idสคริปต์ที่ยังอยู่ของโปรเจกต์เดียวกัน หรือ null เพื่อไม่แสดง

อย่างน้อยหนึ่งฟิลด์ ใช้ลิมิตเดียวกับ dashboard คำตอบคือ key_system ที่อัปเดตแล้ว slug เลขฐานสิบหกถูกสร้างอัตโนมัติและแก้ไขไม่ได้ ส่วนหน้าตาของหน้า และ provider กับลิงก์ของด่านแก้ที่ dashboard

กฎป้องกันที่ตั้งผ่านที่นี่ใช้งานจริงทันที: ถ้าคำขอมี require_discord, block_vpn หรือ blocked_countries การทดลองที่แดชบอร์ดเริ่มไว้สำหรับกฎนั้นจะจบลง (กฎที่อยู่ในโหมดทดลองแค่จดว่าจะกันใคร) ส่วนว่า require_discord ขอจากใคร (ทุกคน หรือเฉพาะคนที่ดูเสี่ยง) เป็นค่าที่ตั้งในแดชบอร์ด

PATCH /v3/projects/:id/key-systems/:key_system_id/steps/:step_id

active, required_seconds (0 ถึง 600 เวลาขั้นต่ำที่ด่านใช้ได้) และ title อย่างน้อยหนึ่งอย่าง ส่วนอื่นใน body จะถูกเมิน

ยอดผู้ใช้ การเข้าชม และการบล็อก

GET /v3/projects/:id/key-systems/:key_system_id/stats

days เป็น 7 (ค่าเริ่มต้น) หรือ 30 คำตอบมี funnel (visit, start, step, complete, claim, block), countries และ blocked_because (เหตุที่ผู้เข้าชมถูกปฏิเสธ: vpn, country, captcha, bypass, discord, limit)

GET /v3/projects/:id/key-systems/:key_system_id/visits

การเข้าชมล่าสุด ใหม่สุดก่อน: limit (1 ถึง 100 ค่าเริ่มต้น 30) และ before (next_before จากหน้าก่อนหน้า เป็นเวลา) แต่ละรายการมี visit_id, status, step, country, browser, vpn, discord_id, started_at และ finished_at ที่อยู่และ id เบราว์เซอร์ของผู้เข้าชมไม่เคยอยู่ในนั้น

GET /v3/projects/:id/key-systems/:key_system_id/blocks

บัญชีและที่อยู่ที่หน้านั้นปฏิเสธ: block_id, kind (discord, ip หรือ visitor), value และ reason ที่อยู่หรือเบราว์เซอร์เก็บเป็นค่า hash เท่านั้น จึงแสดงเฉพาะแปดตัวแรก POST …/blocks พร้อม discord_id (15 ถึง 22 หลัก) และ reason ที่ไม่บังคับ จะบล็อกบัญชี Discord (201 พร้อม block_id; 409 ALREADY_BLOCKED ถ้าบล็อกอยู่แล้ว) DELETE …/blocks/:block_id ปลดหนึ่งอัน (404 BLOCK_NOT_FOUND ถ้าไม่มี) การบล็อกที่อยู่ทำที่ dashboard