REST API untuk bot

Aplikasi menyediakan REST API hanya baca di bawah /api/ext/v1, misalnya untuk bot yang memberi tahu wali kelas tentang siswa yang belum sholat. Aplikasi sendiri tidak mengirim notifikasi WhatsApp.

Autentikasi

Buat key di menu Keamanan > Buat API key (lihat Keamanan), lalu kirim di setiap permintaan:

curl -H "Authorization: Bearer sk_xxx" "https://DOMAIN/api/ext/v1/classes"

Boleh juga memakai header X-API-Key: sk_xxx. Batasnya 120 permintaan per menit per key.

Endpoint

Endpoint	Query	Isi
`GET /api/ext/v1/classes`		Daftar kelas dan jumlah siswa.
`GET /api/ext/v1/students`	`q`, `classId`, `gender` (L/P), `status`, `limit`	Daftar siswa (tanpa token kartu).
`GET /api/ext/v1/records`	`date` (YYYY-MM-DD), `prayer`, `classId`, `gender`	Rekap satu hari, default hari ini. Tiap siswa punya `marks` dan `states`.
`GET /api/ext/v1/absent`	`date`, `prayer`	Siswa yang belum tercatat per kelas beserta wali kelasnya (`wali.name`, `wali.phone` berformat 628xxx), untuk notifikasi bot.

Nilai states pada records: hadir, haid, izin, alpa, belum, atau none.

Pada absent, siswi haid dan siswa izin tidak ikut. Kolom missing berisi sholat yang belum tercatat, dan alpa adalah bagian dari missing yang waktunya sudah berakhir. Pada hari libur dan akhir pekan, classes kosong. Kapan endpoint ini dipanggil (misalnya setelah jendela sholat selesai) diatur oleh bot Anda.

Contoh

curl -H "Authorization: Bearer sk_xxx" \
  "https://DOMAIN/api/ext/v1/records?date=2026-10-23&classId=ID_KELAS&gender=P"

Respons berbentuk:

{ "success": true, "message": "...", "data": { } }

Designed & Developed by NoxlyDev