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

RuteMetodeKeterangan
/peserta?search=&nis=&kelas=&regu=&page=1&limit=50GETCari peserta
/peserta/duplikat-nisGETKelompok NIS ganda
/peserta/{id}GET, PATCHBaca / ubah peserta
/pesertaPOSTTambah peserta
/peserta/{id}/nonaktifkanPATCHArsipkan peserta, tidak menghapus permanen
/pembinaGET, POSTDaftar / tambah pembina
/pembina/{id}GET, PATCHBaca / ubah pembina
/akun?search=GETCari akun portal
/akun/{id}GET, PATCHReset password/recoveryCode pembina biasa saja
/kegiatanGETDaftar kegiatan
/kegiatan/{id}GET, PATCHPerbarui kegiatan
/presensi-peserta/{activityId}GET, PATCHrecords: {memberId: present|excused|sick|absent}; ditolak saat tanggal Libur
/presensi-peserta/liburGETDaftar seluruh tanggal Libur peserta
/presensi-peserta/libur/{YYYY-MM-DD}GET, PATCHisHoliday: true/false, reason: alasan wajib; dry_run=true tersedia
/presensi-pembina/{YYYY-MM-DD}GET, PATCHrecords: {coachId: {status,note}}
/sku/{memberId}GET, PATCHchecks: {Siaga_Mula_1: true}
/penilaian/{YYYY-YYYY}/{term}/{memberId}GET, PATCHscore: 0-100, notes: string; term=uts1/uas1/uts2/uas2
/dokumentasiGETDaftar metadata dokumentasi
/dokumentasi/{id}GET, PATCHUbah judul, catatan, aktivitas, visibility; tidak unggah file
/dashboardGETRingkasan 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.