Referensi API v3
Endpoint saat ini untuk metadata workspace, proyek, statistik, dan pengelolaan license key.
Route terautentikasi memerlukan kunci API workspace. Akses dibatasi scope, batasan proyek, dan whitelist IP. Ganti PROJECT_ID dengan proyek yang diizinkan dari Dashboard atau GET /v3/projects. Kunci lisensi berisi 32 huruf ASCII (A–Z, a–z).
Authorization: Bearer YOUR_DEVELOPER_API_KEY
Content-Type: application/jsonBody berupa JSON: default 16 KiB, sumber skrip 4 MiB, POST kunci bulk 512 KiB. Field tidak valid mengembalikan 400 INVALID_FIELD dengan details. Lihat ringkasan.
Status publik
GET /v3/status
Tidak perlu autentikasi.
curl "https://api.luaward.com/v3/status"Respons berisi success, status, time (detik Unix), dan version API.
Metadata workspace
GET /v3/keys/:key/details
Memerlukan autentikasi. Mengembalikan plan workspace, rate_limit kunci, dan projects: semua proyek yang ada dengan project_id, project_name, reset_hwid_allowed, reset_hwid_cooldown_days (berapa hari pemain menunggu antar reset perangkatnya sendiri; reset lewat API mengabaikannya), auto_delete_expired, allow_cloned_hwid, total_users, created_at, dan scripts-nya (script_id, script_name, enabled, ffa). Segmen :key adalah penanda yang tidak pernah dibaca. Tulis kata apa saja seperti me, dan jangan pernah menaruh kunci API di sana, karena alamat tercatat di log.
GET /v3/keys/:key/stats
Memerlukan autentikasi. Mengembalikan total seluruh workspace: total_projects, total_users, active_users, dan total_executions. Bukan laporan untuk satu license key. Juga mengembalikan limits: untuk proyek, skrip, dan kunci, berapa yang terpakai (used) dan berapa yang diizinkan plan (max). Tambahkan ?noUsers=true untuk menghilangkan hitungan pengguna dan angka kunci (lebih cepat di workspace dengan kunci sangat banyak).
Proyek
Proyek menghimpun skrip dan license key yang membukanya. Membuat, mengganti nama, dan menghapus proyek mengikuti aturan yang sama dengan dashboard, termasuk batas proyek planmu.
GET /v3/projects
Mengembalikan projects: objek yang sama dengan jawaban details, dari yang terlama.
GET /v3/projects/:id
Mengembalikan satu project. Proyek yang tidak ada di workspacemu, sudah dihapus, atau tidak ada dijawab 404 dengan kode PROJECT_NOT_FOUND.
POST /v3/projects
{
"name": "My new project",
"reset_hwid_allowed": true,
"reset_hwid_cooldown_days": 7
}| Field | Aturan |
|---|---|
| name | Wajib. 1 sampai 60 karakter. |
| reset_hwid_allowed | Opsional. Apakah pemain boleh mereset perangkatnya sendiri. |
| reset_hwid_cooldown_days | Opsional. 0 sampai 365. |
| auto_delete_expired | Opsional. Hapus kunci kedaluwarsa secara otomatis. |
| allow_cloned_hwid | Opsional. Izinkan satu kunci berjalan di beberapa mesin yang berbagi id perangkat. |
Berhasil mengembalikan 201 dan project baru. Webhook dan daftar "terima juga kunci dari" diatur di dashboard. Penolakan: 403 PLAN_LIMIT saat workspace sudah di batas proyek.
curl -X POST "https://api.luaward.com/v3/projects" \
-H "Authorization: Bearer YOUR_DEVELOPER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"My new project"}'PATCH /v3/projects/:id
Field mana pun di atas; minimal satu wajib. Field yang tidak dikirim tetap bernilai sama. Mengembalikan project yang diperbarui.
DELETE /v3/projects/:id
{ "confirm_name": "My new project" }Menghapus memerlukan nama persis proyek di confirm_name, supaya id yang salah tidak menghapus proyek yang salah (jika tidak, 400 CONFIRM_REQUIRED). Seperti di dashboard, proyek dan skripnya berhenti bekerja seketika dan hilang dari daftar. Berhasil mengembalikan Project deleted successfully.
Daftar license key
GET /v3/projects/:id/users
Query parameter opsional:
| Parameter | Arti |
|---|---|
| page | Nomor halaman, 1 sampai 100000; bawaan 1. |
| limit | Hasil per halaman, 1 sampai 100; bawaan 50. |
| from | Awal jendela pengguna, dihitung dari yang terbaru (0 atau lebih). Jika dikirim, dipakai menggantikan page dan limit. |
| until | Akhir jendela itu: di atas from, paling banyak 100. Bawaannya from + 50. |
| search | Maksimal 80 karakter, dicocokkan dengan key, note, Discord id, dan identifier. % dan _ dihitung sebagai karakter biasa. |
| user_key | Filter license key persis (32 huruf). |
| discord_id | Filter Discord id persis (15 sampai 22 digit). |
| identifier | Filter identifier perangkat persis. |
| status | unused, active, reset, atau banned. |
Nilai yang melanggar aturan mengembalikan 400; parameter kosong diabaikan. Respons berisi users, total, page, dan limit. Setiap user punya user_key, identifier, identifier_type, discord_id, note, auth_expire, key_days, status, banned, ban_reason, total_resets, total_executions, created_at, dan last_executed_at. Dengan jendela, jawaban berisi from dan until sebagai ganti page dan limit.
Buat license key
POST /v3/projects/:id/users
{
"note": "Customer order 492",
"discord_id": "123456789012345678",
"key_days": 30
}| Field | Aturan |
|---|---|
| user_key | Opsional. Tepat 32 huruf; Luaward membuatkan jika dikosongkan. |
| note | Maksimal 200 karakter. |
| discord_id | 15 sampai 22 digit. |
| identifier | 8 sampai 200 karakter; mengikat kunci ke perangkat lebih dulu. |
| key_days | 1 sampai 36500. Kunci berlaku sekian hari sejak pemakaian pertama. |
| auth_expire | Detik Unix (sampai tahun 2100) saat kunci berakhir, atau -1 untuk tanpa akhir. Jika diisi, key_days diabaikan. |
Tanpa key_days maupun auth_expire, kunci tidak kedaluwarsa. Respons mengembalikan user_key, key_days, auth_expire, dan created_at. Kunci lisensi juga dapat dibaca melalui endpoint users terautentikasi; bukan hanya sekali ditampilkan. Kunci API developer adalah kredensial berbeda yang hanya ditampilkan saat dibuat.
curl -X POST "https://api.luaward.com/v3/projects/PROJECT_ID/users" \
-H "Authorization: Bearer YOUR_DEVELOPER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"note":"Customer order 492","key_days":30}'Penolakan: 403 PLAN_LIMIT saat workspace mencapai batas kunci, 409 KEY_EXISTS saat kunci itu sudah ada.
Perbarui kunci
PATCH /v3/projects/:id/users
Body harus menyertakan user_key, dan setidaknya satu dari note (teks, atau null untuk mengosongkan), discord_id (digit, atau null untuk mengosongkan), dan auth_expire (seperti di atas; menggantikan key_days). identifier juga diterima: 8 sampai 200 karakter untuk mengikat kunci ke perangkat, atau null untuk melepas ikatan.
{
"user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf",
"note": "Renewed",
"auth_expire": -1
}Hapus kunci
DELETE /v3/projects/:id/users
Kirim user_key dalam body JSON, atau sebagai query parameter seperti yang dilakukan Luarmor (body menjaga kunci tetap di luar alamat). Keberhasilan mengembalikan User deleted successfully. Penghapusan dicatat di log audit workspace.
Reset pengikatan perangkat
POST /v3/projects/:id/users/reset-hwid
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf" }Keberhasilan mengembalikan HWID reset successfully. Eksekusi valid berikutnya dapat mengikat kunci ke perangkat lagi. Seperti reset pemilik di dashboard, ini mengabaikan cooldown proyek. Penulisan Luarmor POST /v3/projects/:id/users/resethwid juga berfungsi. force diterima tetapi tidak mengubah apa pun, karena reset di sini selalu melewati cooldown.
Menautkan akun Discord
POST /v3/projects/:id/users/linkdiscord
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "discord_id": "123456789012345678" }discord_id terdiri dari 15 sampai 22 digit. Kunci yang sudah tertaut ke akun lain tidak diubah dan dijawab 409 ALREADY_LINKED, kecuali kamu mengirim "force": true. Menautkan akun yang sama lagi berhasil. Hasilnya sama dengan mengisi discord_id lewat PATCH, dengan perlindungan itu.
Blokir dan buka blokir kunci
POST /v3/projects/:id/users/ban
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "reason": "Refunded order", "until": 1893456000 }reason maksimal 200 karakter. until adalah waktu Unix berakhirnya blokir; kosongkan untuk blokir permanen. Blokir baru menggantikan tanggal akhir blokir sebelumnya. Respons berisi unban_token (32 huruf) yang diterima tautan unban loader. Untuk membuka blokir lewat API, panggil POST /v3/projects/:id/users/unban dengan body berisi user_key; ini menghapus alasan, tanggal akhir, dan token. Rute Luarmor POST /v3/projects/:id/users/blacklist beserta nama ban_reason dan ban_expire (-1 berarti permanen) juga berfungsi; jika kedua penulisan dikirim, milik kami yang dipakai. Pemegang token juga bisa mencabut blokir tanpa kunci API, dengan GET /v3/projects/:id/users/unban?unban_token=TOKEN: hanya berlaku sekali, hanya di dalam proyek itu, dan dibatasi 10 percobaan per menit per alamat.
Respons error umum
Error berisi success: false, kalimat error, dan code. 400 adalah body atau field yang melanggar aturan, 401 kunci tidak ada, salah, atau dicabut, 403 alamat di luar daftar, akun ditangguhkan, atau batas kunci atau proyek plan, 404 proyek atau kunci yang tidak ada, 409 kunci ganda, 413 body lebih dari 16 KB, dan 429 batas laju. Ringkasan memuat tabel lengkapnya.