API สคริปต์
ดู สร้าง แก้ อัปโหลดโค้ด และลบสคริปต์ พร้อมติดตาม build
สคริปต์เป็นของโปรเจกต์หนึ่ง route เหล่านี้ใช้ดู สร้าง แก้ ลบสคริปต์ อัปโหลดโค้ดใหม่ และติดตาม build ที่แปลงโค้ดเป็นสคริปต์ที่ผู้เล่นโหลด การเปลี่ยนสคริปต์ต้องใช้คีย์ที่มี scope scripts:write (สิทธิ์เต็มรูปแบบมีให้) ส่วนการอ่านไม่ต้องใช้ scope
การอ่านยังต้องใช้ developer API key ที่ใช้งานได้ แต่ไม่ต้องมี scope scripts:write
อ่านข้อมูลสคริปต์
GET /v3/projects/:id/scripts
คืน scripts เรียงจากเก่าไปใหม่ ส่วน GET /v3/projects/:id/scripts/:script_id คืน script หนึ่งอัน สคริปต์ที่ไม่ได้อยู่ในโปรเจกต์นี้ ถูกลบแล้ว หรือไม่มีอยู่ ตอบ 404 SCRIPT_NOT_FOUND
สคริปต์มี script_id, script_name, project_id, enabled (kill switch), paused_reason (null หรือเหตุผลที่ Luaward ปิด: plan, owner, ban), version, การตั้งค่า ffa, silent, heartbeat, lightning, preset (max, balanced หรือ fast) และ auto_rebuild, loader_url กับ loadstring (สิ่งที่ผู้เล่นวางใน runtime), current_build (build_id, version, status), stable_build_id, created_at และ updated_at
สร้างสคริปต์
POST /v3/projects/:id/scripts
| ฟิลด์ | กติกา |
|---|---|
| name | จำเป็น 1 ถึง 60 ตัวอักษร |
| script | จำเป็น (ใช้ source ก็ได้) โค้ด ไม่เกิน 2,000,000 ตัวอักษร |
| ffa, silent, heartbeat, lightning, auto_rebuild | ไม่บังคับ true หรือ false โดย ffa ทำให้สคริปต์ไม่ต้องใช้คีย์ |
| preset | ไม่บังคับ: max, balanced (ค่าเริ่มต้น) หรือ fast |
curl -X POST "https://api.luaward.com/v3/projects/PROJECT_ID/scripts" \
-H "Authorization: Bearer YOUR_DEVELOPER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Arena","script":"print(\"hello\")","ffa":false,"preset":"balanced"}'คำตอบคือ 202 พร้อม script_id, build_id, version (1), status เป็น queued และ script: โค้ดถูกเก็บแบบเข้ารหัสและ build เข้าคิวแล้ว แต่ยังไม่เสร็จ ติดตามได้ด้วย route ของ build ด้านล่าง ปฏิเสธเมื่อ: 403 PLAN_LIMIT ถึงลิมิตสคริปต์ของแผน, 404 PROJECT_NOT_FOUND, 429 TOO_MANY_BUILDS เมื่อ workspace มี build รออยู่หลายอัน, 503 UNAVAILABLE เมื่อ API ติดต่อบริการ build ไม่ได้ body ของ route โค้ดสองตัวนี้ใหญ่ได้ถึง 4 MiB. ค่าเริ่มต้น 16 KiB และ route คีย์แบบ bulk รองรับ 512 KiB
อัปโหลดโค้ดใหม่
PUT /v3/projects/:id/scripts/:script_id
ส่ง script (หรือ source) และจะส่งการตั้งค่าตัวใดก็ได้ด้วย version จะเพิ่มทีละหนึ่งและ build ใหม่เข้าคิว ผู้เล่นยังใช้ build เก่าจนกว่าตัวใหม่พร้อม การตั้งค่าที่ส่งมากับโค้ดจะใช้กับ build เดียวกันนั้น อัปโหลดพร้อมกันสองครั้งได้สอง version คำตอบคือ 202 พร้อม script_id, build_id, version และ status เป็น queued
ติดตาม build
GET /v3/projects/:id/scripts/:script_id/builds
คืน builds เรียงจากใหม่ไปเก่า (limit 1 ถึง 50 ค่าเริ่มต้น 20) ส่วน GET …/builds/:build_id คืน build หนึ่งอัน: build_id, version, status (queued, building, ready หรือ failed), error (ข้อความจากคอมไพเลอร์เมื่อล้มเหลว), size_bytes, is_stable, current (ผู้เล่นได้ตัวนี้) , created_at และ finished_at build ใช้เวลาตั้งแต่ไม่กี่วินาทีถึงไม่กี่นาที ให้ poll ทุกไม่กี่วินาที:
build_id=BUILD_ID
build_deadline=$((SECONDS + 180))
build_status=""
while (( SECONDS < build_deadline )); do
build_remaining=$((build_deadline - SECONDS))
(( build_remaining > 15 )) && build_remaining=15
build_response=$(curl --fail-with-body --silent --show-error --connect-timeout 5 --max-time "$build_remaining" \
-H "Authorization: Bearer $LUAWARD_API_KEY" \
"https://api.luaward.com/v3/projects/PROJECT_ID/scripts/SCRIPT_ID/builds/$build_id") || exit 1
build_status=$(printf '%s' "$build_response" | jq -er '.build.status') || exit 1
case "$build_status" in
ready) printf '%s\n' "$build_response"; break ;;
failed) printf '%s\n' "$build_response" | jq -r '.build.error // "Build failed"' >&2; exit 1 ;;
queued|building)
build_remaining=$((build_deadline - SECONDS))
(( build_remaining > 0 )) || break
(( build_remaining > 3 )) && build_remaining=3
sleep "$build_remaining" ;;
*) printf 'Unexpected build status: %s\n' "$build_status" >&2; exit 1 ;;
esac
done
if [[ "$build_status" != ready ]]; then
printf 'Build did not finish within 180 seconds\n' >&2
exit 1
fiแก้ไขสคริปต์
PATCH /v3/projects/:id/scripts/:script_id
ส่ง name, enabled (kill switch) และการตั้งค่าตัวใดก็ได้ อย่างน้อยหนึ่งอย่าง การเปิดสคริปต์ต้องมีที่ว่างในแผน (403 PLAN_LIMIT) สคริปต์ที่ Luaward เองปิดไว้ (paused_reason เป็น owner หรือ ban) เปิดที่นี่ไม่ได้ (403 SCRIPT_LOCKED) การเปลี่ยน preset หรือ lightning เปลี่ยนผลลัพธ์ที่ป้องกัน จึงมี build ใหม่เข้าคิว: คำตอบบอก rebuilding เป็น true พร้อม build_id ส่วนการตั้งค่าอื่นมีผลทันที
ย้อนกลับ
POST /v3/projects/:id/scripts/:script_id/rollback
{ "build_id": "0123456789abcdef0123456789abcdef" }ให้บริการ build เก่าที่ ready อีกครั้ง build ที่ยังไม่เสร็จตอบ 400 BUILD_NOT_READY ส่วน build ที่ไม่ใช่ของสคริปต์นี้ตอบ 404 BUILD_NOT_FOUND
ลบและกู้คืน
DELETE /v3/projects/:id/scripts/:script_id
เป็นการลบแบบ soft delete: ปฏิเสธคำขอ loader ใหม่แต่ยังเก็บ record ของสคริปต์ POST …/:script_id/restore กู้ได้เมื่อโปรเจกต์ยังอยู่และแผนมีที่ว่าง (ไม่เช่นนั้น 403 PLAN_LIMIT) ไม่ได้หมายความว่าข้อมูลจะถูกลบถาวรอัตโนมัติหลัง 30 วัน ดูการลบบัญชี ทั้งสอง operation มี audit