Schools API

Kelola data sekolah (tenant). Setiap API client terikat dengan satu sekolah — data terisolasi otomatis.

Base URL: https://sekolahku.sains.dev/api/v1

bash — contoh request

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

List Schools

GET

/schools

List semua sekolah

▶

Hanya superadmin yang bisa list semua sekolah. Token biasa hanya bisa akses sekolah miliknya sendiri.

Parameter	Type	Required	Description
is_active	boolean	optional	Filter sekolah aktif
status	string	optional	`negeri` atau `swasta`
level	string	optional	`sd`, `smp`, `sma`, `smk`
page	integer	optional	Halaman (default: 1)

🧪 Try It

Access Token

POST

/schools

Buat sekolah baru

▶

Hanya superadmin. Buat sekolah baru dan sekaligus generate API client.

Field	Type	Required	Description
name	string	required	Nama sekolah
npsn	string(8)	optional	Nomor NPSN (8 digit)
status	string	required	`negeri` atau `swasta`
level	string	required	`sd`, `smp`, `sma`, `smk`, `slb`
city	string	optional	Kota/Kabupaten
province	string	optional	Provinsi
dapodik_server_url	string	optional	URL server Dapodik
dapodik_username	string	optional	Username Dapodik
dapodik_password	string	optional	Password Dapodik
create_api_client	boolean	optional	Generate API client secara otomatis (default: false)

🧪 Try It

Access Token name status level

GET

/schools/{id}

Detail sekolah

▶

Ambil detail satu sekolah. Superadmin bisa lihat semua; client biasa hanya sekolah miliknya.

PUT

/schools/{id}

Update sekolah

▶

Update data sekolah. Field sama dengan create.

DELETE

/schools/{id}

Hapus sekolah

▶

Hapus sekolah (soft delete). Hanya superadmin.