API sistem kunci
Baca dan ubah halaman kunci gratis proyek: pengaturan, langkah, corong, kunjungan, dan akun yang diblokir.
Halaman kunci gratis proyek (key.luaward.com/getkey/…) membagikan kunci berbatas waktu setelah pengunjung menyelesaikan langkah yang kamu atur. Route ini membacanya dan mengubah hal yang aman diubah dari program. Mengubah memerlukan kunci dengan scope keysystem:write (Akses penuh memilikinya). Untuk membuat kunci sementara sendiri, buat kunci biasa dengan key_days.
Membaca
GET /v3/projects/:id/key-systems
Mengembalikan key_systems. GET …/key-systems/:key_system_id mengembalikan satu dengan steps-nya, berurutan. Sistem kunci memiliki key_system_id, name, slug, page_url, project_id, script_id (skrip yang loadstring-nya ditampilkan halaman), enabled, key_hours, max_keys_per_visitor, allow_extending, allow_forgetting, require_discord, block_vpn, blocked_countries, session_timeout_seconds, enforce_ip_match, steps, created_at, dan updated_at. Sebuah langkah memiliki step_id, position, title, provider, target_url, required_seconds, dan active. Yang tidak ada di proyek ini dijawab 404 KEY_SYSTEM_NOT_FOUND.
Mengubah pengaturan
PATCH /v3/projects/:id/key-systems/:key_system_id
| Field | Aturan |
|---|---|
| name | 1 sampai 80 karakter. |
| enabled, allow_extending, allow_forgetting, require_discord, block_vpn, enforce_ip_match | true atau false. |
| key_hours | Lama kunci berlaku: 0,25 sampai 8760 jam. |
| max_keys_per_visitor | 1 sampai 20. |
| blocked_countries | Hingga 250 kode dua huruf kapital, seperti RU. |
| session_timeout_seconds | 300 sampai 86400. |
| script_id | Skrip aktif dari proyek yang sama, atau null untuk tidak menampilkan. |
Minimal satu field; batasnya sama dengan dashboard. Jawabannya adalah key_system yang diperbarui. Slug heksadesimal dibuat otomatis dan tidak dapat diedit. Tampilan halaman serta penyedia dan tautan langkah diubah di dashboard.
Aturan perlindungan yang diatur di sini langsung aktif sungguhan: require_discord, block_vpn atau blocked_countries dalam permintaan mengakhiri uji coba yang dimulai dasbor untuk aturan itu (aturan dalam uji coba hanya mencatat siapa yang akan dihentikan). Siapa yang diminta oleh require_discord (semua orang, atau hanya pengunjung yang tampak berisiko) adalah pengaturan di dasbor.
PATCH /v3/projects/:id/key-systems/:key_system_id/steps/:step_id
active, required_seconds (0 sampai 600, waktu tercepat yang boleh dipakai langkah) dan title, minimal satu. Hal lain di body diabaikan.
Corong, kunjungan, dan blokir
GET /v3/projects/:id/key-systems/:key_system_id/stats
days adalah 7 (bawaan) atau 30. Jawabannya memuat funnel (visit, start, step, complete, claim, block), countries, dan blocked_because (alasan pengunjung ditolak: vpn, country, captcha, bypass, discord, limit).
GET /v3/projects/:id/key-systems/:key_system_id/visits
Kunjungan terbaru, dari yang terbaru: limit (1 sampai 100, bawaan 30) dan before (next_before dari halaman sebelumnya, berupa cap waktu). Masing-masing memuat visit_id, status, step, country, browser, vpn, discord_id, started_at, dan finished_at. Alamat dan id browser pengunjung tidak pernah menjadi bagiannya.
GET /v3/projects/:id/key-systems/:key_system_id/blocks
Akun dan alamat yang ditolak halaman: block_id, kind (discord, ip, atau visitor), value, dan reason. Alamat atau browser disimpan hanya sebagai hash, jadi hanya delapan karakter pertama yang ditampilkan. POST …/blocks dengan discord_id (15 sampai 22 digit) dan reason opsional memblokir akun Discord (201 dengan block_id; 409 ALREADY_BLOCKED jika sudah). DELETE …/blocks/:block_id mencabut satu (404 BLOCK_NOT_FOUND jika tidak ada). Memblokir alamat dilakukan di dashboard.