Internal API

API internal untuk pengelolaan data siswa, guru, dan kelas di dalam satu sekolah. Tenant-scoped — setiap request otomatis ter-filter ke sekolah token.

bash — contoh

curl -X GET https://sekolahku.sains.dev/api/v1/internal/students \
  -H "Authorization: Bearer {access_token}" \
  -H "Accept: application/json"

Students

GET

/internal/students

List siswa

▶

Ambil list siswa sekolah ini dengan filter dan pencarian. Include data kelas dan enrollment.

Parameter	Type	Description
search	string	Cari nama, NISN, atau NIS
gender	string	`L` atau `P`
class_id	integer	Filter siswa di kelas tertentu
per_page	integer	Jumlah per halaman (default: 25)

🧪 Try It — GET Students

Access Token search (opsional)

POST

/internal/students

Tambah siswa

▶

Tambah siswa baru ke sekolah ini. Field sama dengan data Dapodik.

Field	Type	Required	Description
nama	string	required	Nama lengkap
nisn	string(10)	optional	NISN
nis	string	optional	NIS
nik	string(16)	optional	NIK/KTP
jenis_kelamin	string	required	`L` atau `P`
tanggal_lahir	date	required	YYYY-MM-DD
tempat_lahir	string	required	Kota lahir
alamat	string	optional	Alamat lengkap

GET

/internal/students/{id}

Detail siswa

▶

Ambil detail satu siswa dengan enrollment dan kelas.

PUT

/internal/students/{id}

Update siswa

▶

Update data siswa.

DELETE

/internal/students/{id}

Hapus siswa

▶

Hapus siswa (soft delete).

Teachers

GET

/internal/teachers

List guru

▶

Ambil list guru dengan pencarian nama.

🧪 Try It

Access Token

Classes

GET

/internal/classes

List kelas

▶

Ambil list rombel dengan filter tingkat dan include wali kelas & anggota.

Parameter	Type	Description
tingkat	string	Tingkat kelas (10, 11, 12)

🧪 Try It

Access Token