Kunci massal dan ekspor
Buat atau impor hingga seribu kunci, proses hingga lima ratus sekaligus, dan ekspor sebagai JSON atau CSV.
POST kunci bulk menerima JSON hingga 512 KiB. POST/PUT kode menerima 4 MiB; permintaan lain memiliki batas default 16 KiB. Penulisan memerlukan keys:write; ekspor memerlukan kunci aktif dengan akses ke proyek.
Membuat banyak kunci
POST /v3/projects/:id/users/bulk
Kirim count (1 sampai 1000) untuk membuat kunci sebanyak itu, atau users (1 sampai 1000) untuk mengimpor kunci yang sudah kamu punya, misalnya saat pindah dari Luarmor. Salah satu, bukan keduanya.
{ "count": 200, "note": "Giveaway", "key_days": 30 }{
"users": [
{ "user_key": "AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "note": "from Luarmor", "discord_id": "123456789012345678", "auth_expire": 1893456000 }
]
}Dengan count, note, key_days, dan auth_expire berlaku seperti untuk satu kunci (seumur hidup jika tidak ada akhir). Dengan users, setiap entri memuat user_key (32 huruf) dan opsional note, discord_id, identifier, key_days, atau auth_expire. Jawabannya memuat created dan, untuk count, user_keys; untuk users, daftar skipped berisi kunci yang sudah ada (kode KEY_EXISTS). Batas kunci plan diperiksa di bawah kunci pengaman: panggilan yang tidak muat tidak membuat apa pun (403 PLAN_LIMIT), dan panggilan bersamaan tidak bisa sama-sama melewati batas.
Memproses banyak kunci
| Route | Fungsinya |
|---|---|
| POST /v3/projects/:id/users/bulk/ban | Memblokir kunci (reason, until seperti satu kunci). Jawaban memuat objek unban_tokens, satu token per kunci. |
| POST /v3/projects/:id/users/bulk/unban | Membuka blokir. |
| POST /v3/projects/:id/users/bulk/resethwid | Melepas kunci dari perangkatnya (reset-hwid juga bisa). Melewati cooldown proyek, seperti reset oleh pemilik. |
| POST /v3/projects/:id/users/bulk/delete | Menghapus kunci. Masing-masing dicatat di log audit. |
| POST /v3/projects/:id/users/bulk/extend | Menambah days (1 sampai 36500). Kunci yang sudah berakhir mendapat hari dihitung dari hari ini; yang masih berjalan ditambahkan ke akhirnya; kunci "hari sejak pemakaian pertama" yang belum dipakai mendapat tambahan hari; kunci seumur hidup tidak diubah dan dicantumkan di unchanged. |
{ "user_keys": ["AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEf", "ZyXwVuTsRqPoNmLkJiHgFeDcBaZyXwVu"], "days": 30 }user_keys berisi 1 sampai 500 kunci (duplikat dihitung sekali). Jawabannya memuat updated dan not_found, kunci yang tidak ada di proyek ini (kunci proyek atau workspace lain terlihat sama). Setiap perubahan dicatat di riwayat kunci dengan nama kunci API.
Mengekspor kunci
GET /v3/projects/:id/users/export
| Parameter | Arti |
|---|---|
| format | json (bawaan) atau csv. |
| status | unused, active, reset, atau banned. |
| limit | Kunci per panggilan, 1 sampai 50000; bawaan 10000. |
| cursor | next_cursor dari panggilan sebelumnya. |
Kunci datang dari yang terlama dan halaman-halamannya menyambung tanpa pengulangan atau celah, bahkan untuk kunci yang dibuat pada saat yang sama. JSON menjawab users, count, dan next_cursor (null di halaman terakhir). CSV punya baris judul dan kolom yang sama dengan kunci di daftar; cursor ada di header X-Next-Cursor. Sel yang diawali =, +, -, atau @ ditulis dengan tanda kutip di depan agar spreadsheet menampilkannya sebagai teks, bukan rumus.