LuawardDocs

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 ส่วนการตั้งค่าอื่นมีผลทันที

สคริปต์ที่ปิดจะปฏิเสธ authorization/payload ใหม่ เซสชันที่มีคีย์และเปิด heartbeat จะหยุดตอนตรวจครั้งถัดไป ส่วนโค้ดที่โหลดไปรันแล้วโดยไม่มี heartbeat ไม่สามารถรับประกันว่าจะหยุดจากระยะไกลได้

ย้อนกลับ

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