LuawardDocs

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/json

Body 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
}
FieldAturan
nameWajib. 1 sampai 60 karakter.
reset_hwid_allowedOpsional. Apakah pemain boleh mereset perangkatnya sendiri.
reset_hwid_cooldown_daysOpsional. 0 sampai 365.
auto_delete_expiredOpsional. Hapus kunci kedaluwarsa secara otomatis.
allow_cloned_hwidOpsional. 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:

ParameterArti
pageNomor halaman, 1 sampai 100000; bawaan 1.
limitHasil per halaman, 1 sampai 100; bawaan 50.
fromAwal jendela pengguna, dihitung dari yang terbaru (0 atau lebih). Jika dikirim, dipakai menggantikan page dan limit.
untilAkhir jendela itu: di atas from, paling banyak 100. Bawaannya from + 50.
searchMaksimal 80 karakter, dicocokkan dengan key, note, Discord id, dan identifier. % dan _ dihitung sebagai karakter biasa.
user_keyFilter license key persis (32 huruf).
discord_idFilter Discord id persis (15 sampai 22 digit).
identifierFilter identifier perangkat persis.
statusunused, 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
}
FieldAturan
user_keyOpsional. Tepat 32 huruf; Luaward membuatkan jika dikosongkan.
noteMaksimal 200 karakter.
discord_id15 sampai 22 digit.
identifier8 sampai 200 karakter; mengikat kunci ke perangkat lebih dulu.
key_days1 sampai 36500. Kunci berlaku sekian hari sejak pemakaian pertama.
auth_expireDetik 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.