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/v3Gunakan 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_KEYAPI juga menerima header api-key. Kunci tidak pernah diterima di alamat (misalnya sebagai query parameter), karena alamat berakhir di log.
Batasan
| Apa | Batas |
|---|---|
| Permintaan per kunci | 60 per menit. Lebih dari itu: HTTP 429 dengan header Retry-After. |
| Kunci salah dari satu alamat | 30 per menit. Setelah itu alamat menunggu semenit (429). |
| Body permintaan | Default: 16 KiB. Sumber skrip: 4 MiB; kunci bulk: 512 KiB. Body lebih besar mengembalikan 413. |
| License key | Kunci yang dibuat lewat API dihitung dalam batas kunci planmu, bersama yang dibuat di dashboard. Di batas, pembuatan mengembalikan 403 dengan PLAN_LIMIT. |
| Proyek | Proyek 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.
| Status | Kode | Arti |
|---|---|---|
| 400 | INVALID_BODY, INVALID_FIELD | Body bukan JSON atau ada field yang melanggar aturan. INVALID_FIELD menambahkan daftar details yang menyebut tiap field. |
| 400 | CONFIRM_REQUIRED | Menghapus proyek memerlukan nama persisnya di confirm_name. |
| 401 | UNAUTHORIZED | Kunci tidak ada, salah, atau dicabut. |
| 403 | SUSPENDED | Akun pemilik workspace ditangguhkan. |
| 403 | IP_NOT_ALLOWED | Alamat tidak ada di daftar IP yang diizinkan milik workspace. |
| 403 | PLAN_LIMIT | Workspace sudah mencapai batas kunci atau proyek. |
| 403 | INSUFFICIENT_SCOPE | Kunci tidak boleh melakukan ini: hanya baca, mengelola kunci tetapi bukan proyek, atau dibatasi ke beberapa proyek lalu mencoba membuat proyek. |
| 400 | BUILD_NOT_READY | Hanya build yang sudah selesai yang bisa disajikan. |
| 403 | SCRIPT_LOCKED | Luaward mematikan skrip ini; tidak bisa dinyalakan di sini. |
| 404 | SCRIPT_NOT_FOUND, BUILD_NOT_FOUND | Tidak ada skrip itu di proyek ini, atau build itu untuk skrip ini. |
| 404 | KEY_SYSTEM_NOT_FOUND, STEP_NOT_FOUND, BLOCK_NOT_FOUND | Tidak ada sistem kunci, langkah, atau blokir itu di proyek ini. |
| 409 | ALREADY_BLOCKED | Akun Discord itu sudah diblokir di halaman ini. |
| 429 | TOO_MANY_BUILDS | Workspace sudah punya beberapa build yang menunggu. |
| 503 | UNAVAILABLE | API tidak bisa menjangkau layanan yang menyegel dan membangun kode. |
| 503 | TEMPORARILY_UNAVAILABLE | Sementara tidak tersedia. Tunggu Retry-After: 30 sebelum mencoba lagi. |
| 404 | PROJECT_NOT_FOUND | Tidak ada proyek itu di workspace ini. Proyek workspace lain, proyek yang dihapus, dan id karangan dijawab sama. |
| 404 | NOT_FOUND | Tidak ada kunci itu di proyek ini. |
| 409 | KEY_EXISTS | Kunci dengan nilai itu sudah ada. |
| 409 | ALREADY_LINKED | Kunci sudah tertaut ke akun Discord lain; kirim force untuk menggantinya. |
| 413 | TOO_LARGE | Body melampaui batas endpoint ini. |
| 429 | RATE_LIMIT | Terlalu 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.