LuawardDocs

Ringkasan Developer API

Autentikasi permintaan, pahami batas laju, dan kelola proyek serta license key workspace.

Base URL

Developer API dilayani oleh host edge Luaward:

https://api.luaward.com/v3

Gunakan api.luaward.com untuk API v3. Loader memakai luaward.com dan halaman kunci key.luaward.com. Domain khusus belum tersedia.

Paket resmi JavaScript/TypeScript (npm @luaward/sdk), Python (PyPI luaward), dan CLI (npm @luaward/cli) sudah tersedia di registry publik. Lihat SDK dan CLI dan github.com/luaward untuk perintah instalasi dan kredensial. Ekstensi VS Code belum tersedia di Marketplace; hubungi dukungan untuk mendapatkan artefak yang telah diuji.

Buat kunci API

Buka Dashboard → API Developer, lalu buat kunci bernama. Kunci hanya ditampilkan sekali. Luaward hanya menyimpan hash-nya, jadi salin ke penyimpanan rahasia di server dan jangan pernah menaruhnya di skrip, bundle browser, atau repositori publik.

Kunci milik workspace, bukan milik satu proyek, seperti kunci tunggal per akun di Luarmor: ia bisa membaca dan mengubah semua proyek di workspace dan membuat yang baru. Satu workspace bisa punya hingga 10 kunci aktif. Hanya pemilik workspace atau admin yang bisa membuat, mencabut, atau menghapus kunci. Kunci yang dicabut langsung berhenti bekerja.

Saat membuat kunci, kamu memilih apa yang boleh dilakukannya: Akses penuh (semuanya, sekarang dan seiring API bertambah), Kelola kunci (membaca, serta membuat, mengubah, menghapus, mereset, memblokir, dan membuka blokir license key pemain), atau Hanya baca. Kunci juga bisa dibatasi ke beberapa proyek: ia hanya melihat proyek itu (proyek lain dijawab 404 PROJECT_NOT_FOUND, seolah tidak ada), statistiknya hanya menghitung proyek itu, dan ia tidak bisa membuat proyek baru. Panggilan yang tidak boleh dilakukan kunci dijawab 403 INSUFFICIENT_SCOPE. Apa yang boleh dilakukan kunci dan proyek mana yang dijangkaunya ditetapkan saat dibuat; untuk mengubahnya, buat kunci baru lalu cabut yang lama. Skrip dan sistem kunci punya scope sendiri, scripts:write dan keysystem:write: Akses penuh mencakupnya, Kelola kunci tidak.

Autentikasi

Kirim kunci developer di header Authorization:

Authorization: Bearer YOUR_DEVELOPER_API_KEY

API juga menerima header api-key. Kunci tidak pernah diterima di alamat (misalnya sebagai query parameter), karena alamat berakhir di log.

Batasan

ApaBatas
Permintaan per kunci60 per menit. Lebih dari itu: HTTP 429 dengan header Retry-After.
Kunci salah dari satu alamat30 per menit. Setelah itu alamat menunggu semenit (429).
Body permintaanDefault: 16 KiB. Sumber skrip: 4 MiB; kunci bulk: 512 KiB. Body lebih besar mengembalikan 413.
License keyKunci yang dibuat lewat API dihitung dalam batas kunci planmu, bersama yang dibuat di dashboard. Di batas, pembuatan mengembalikan 403 dengan PLAN_LIMIT.
ProyekProyek yang dibuat lewat API dihitung dalam batas proyek planmu dengan cara yang sama (403 dengan PLAN_LIMIT).

IP yang diizinkan

Workspace bisa mengizinkan alamat tempat API-nya boleh dipanggil (Dashboard → API Developer → IP yang diizinkan: hingga 20 alamat lengkap IPv4 atau IPv6, masing-masing dengan catatan pengingat). Satu daftar berlaku untuk semua kunci dan semua proyek workspace. Jika kosong, alamat mana pun bisa memanggil. Jika ada isinya, hanya alamat itu yang bisa, kunci mana pun yang dipakai. Rentang seperti 10.0.0.0/8 tidak didukung, dan pemanggil yang alamatnya tidak terbaca dianggap tidak ada di daftar. Setelah disimpan, dashboard menampilkan alamat dengan bagian akhir tersembunyi, jadi catatan adalah cara kamu mengenalinya. Perubahan berlaku pada panggilan berikutnya.

Saat panggilan ditolak

Error menjawab dengan success: false, kalimat error, dan code yang bisa dibaca program.

StatusKodeArti
400INVALID_BODY, INVALID_FIELDBody bukan JSON atau ada field yang melanggar aturan. INVALID_FIELD menambahkan daftar details yang menyebut tiap field.
400CONFIRM_REQUIREDMenghapus proyek memerlukan nama persisnya di confirm_name.
401UNAUTHORIZEDKunci tidak ada, salah, atau dicabut.
403SUSPENDEDAkun pemilik workspace ditangguhkan.
403IP_NOT_ALLOWEDAlamat tidak ada di daftar IP yang diizinkan milik workspace.
403PLAN_LIMITWorkspace sudah mencapai batas kunci atau proyek.
403INSUFFICIENT_SCOPEKunci tidak boleh melakukan ini: hanya baca, mengelola kunci tetapi bukan proyek, atau dibatasi ke beberapa proyek lalu mencoba membuat proyek.
400BUILD_NOT_READYHanya build yang sudah selesai yang bisa disajikan.
403SCRIPT_LOCKEDLuaward mematikan skrip ini; tidak bisa dinyalakan di sini.
404SCRIPT_NOT_FOUND, BUILD_NOT_FOUNDTidak ada skrip itu di proyek ini, atau build itu untuk skrip ini.
404KEY_SYSTEM_NOT_FOUND, STEP_NOT_FOUND, BLOCK_NOT_FOUNDTidak ada sistem kunci, langkah, atau blokir itu di proyek ini.
409ALREADY_BLOCKEDAkun Discord itu sudah diblokir di halaman ini.
429TOO_MANY_BUILDSWorkspace sudah punya beberapa build yang menunggu.
503UNAVAILABLEAPI tidak bisa menjangkau layanan yang menyegel dan membangun kode.
503TEMPORARILY_UNAVAILABLESementara tidak tersedia. Tunggu Retry-After: 30 sebelum mencoba lagi.
404PROJECT_NOT_FOUNDTidak ada proyek itu di workspace ini. Proyek workspace lain, proyek yang dihapus, dan id karangan dijawab sama.
404NOT_FOUNDTidak ada kunci itu di proyek ini.
409KEY_EXISTSKunci dengan nilai itu sudah ada.
409ALREADY_LINKEDKunci sudah tertaut ke akun Discord lain; kirim force untuk menggantinya.
413TOO_LARGEBody melampaui batas endpoint ini.
429RATE_LIMITTerlalu banyak permintaan, atau terlalu banyak kunci salah dari satu alamat.

Apa yang dicatat

Perubahan lewat API muncul di riwayat license key dengan pelaku api: diikuti nama kunci API: created, extended, hwid_reset, banned, unbanned. Riwayat kunci yang dihapus ikut hilang bersamanya, jadi penghapusan dicatat di log audit workspace. Membuat, mengganti nama, dan menghapus proyek juga dicatat di sana dan tampil di feed aktivitas dashboard. Jawaban tidak pernah disimpan di cache (Cache-Control: no-store).

Operasi yang tersedia

API mengelola proyek, skrip (kode, build, dan sakelar utamanya), license key satu per satu atau massal, dan sistem kunci, serta membaca statistik, eksekusi terbaru, log audit, dan anggota. Lihat referensi API, API skrip, Kunci massal dan ekspor, Statistik, eksekusi, dan log, serta API sistem kunci.