Versi 3.13.2 · Bearer Token · HTTPS
API Cassandra · Scout Is Elegant
Base URL: https://scout.sditmenarakuwait.sch.id/api/v1. Akun layanan cassandra dengan role asisten_ai terikat ke satu sekolah. API tidak memakai cookie login/CSRF browser.
Unduh OpenAPI 3.0 (JSON)
Token
Owner: Sistem → Pengaturan → Token API Cassandra → Buat token. Simpan token saat ditampilkan pertama kali; server hanya menyimpan hash-nya. Token tidak memiliki expiry otomatis dan dapat dicabut kapan saja. Batas 60 request per menit per token.
Endpoint
| Rute | Metode | Keterangan |
/peserta?search=&nis=&kelas=®u=&page=1&limit=50 | GET | Cari peserta |
/peserta/duplikat-nis | GET | Kelompok NIS ganda |
/peserta/{id} | GET, PATCH | Baca / ubah peserta |
/peserta | POST | Tambah peserta |
/peserta/{id}/nonaktifkan | PATCH | Arsipkan peserta, tidak menghapus permanen |
/pembina | GET, POST | Daftar / tambah pembina |
/pembina/{id} | GET, PATCH | Baca / ubah pembina |
/akun?search= | GET | Cari akun portal |
/akun/{id} | GET, PATCH | Reset password/recoveryCode pembina biasa saja |
/kegiatan | GET | Daftar kegiatan |
/kegiatan/{id} | GET, PATCH | Perbarui kegiatan |
/presensi-peserta/{activityId} | GET, PATCH | records: {memberId: present|excused|sick|absent}; ditolak saat tanggal Libur |
/presensi-peserta/libur | GET | Daftar seluruh tanggal Libur peserta |
/presensi-peserta/libur/{YYYY-MM-DD} | GET, PATCH | isHoliday: true/false, reason: alasan wajib; dry_run=true tersedia |
/presensi-pembina/{YYYY-MM-DD} | GET, PATCH | records: {coachId: {status,note}} |
/sku/{memberId} | GET, PATCH | checks: {Siaga_Mula_1: true} |
/penilaian/{YYYY-YYYY}/{term}/{memberId} | GET, PATCH | score: 0-100, notes: string; term=uts1/uas1/uts2/uas2 |
/dokumentasi | GET | Daftar metadata dokumentasi |
/dokumentasi/{id} | GET, PATCH | Ubah judul, catatan, aktivitas, visibility; tidak unggah file |
/dashboard | GET | Ringkasan kumulatif |
Contoh cari NIS
curl -H 'Authorization: Bearer YOUR_TOKEN' \
'https://scout.sditmenarakuwait.sch.id/api/v1/peserta?nis=252601020'
Contoh validasi tanpa menyimpan
curl -X PATCH \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"className":"5A"}' \
'https://scout.sditmenarakuwait.sch.id/api/v1/peserta/mem_123?dry_run=true'
Respons
{"ok":true,"schoolId":"school_x","items":[...],"pagination":{"page":1,"limit":50,"total":1,"totalPages":1}}{"ok":false,"code":"duplicate_nis","message":"NIS 252601020 sudah dipakai oleh ...","field":"nis","conflicts":[{"id":"mem_...","name":"...","className":"5A"}]}
Batasan: dilarang mengubah owner/admin/role/pengaturan sekolah, menghapus permanen, atau mengunggah berkas foto lewat endpoint metadata. Data sebelum/sesudah perubahan dicatat di Audit Log dan informasi rahasia disamarkan.