Dapodik Integration

Sinkronisasi data dari server Dapodik. Semua endpoint Dapodik otomatis ter-scope ke sekolah token — tidak perlu parameter tambahan.

bash — sync semua data

curl -X GET https://sekolahku.sains.dev/api/v1/dapodik/sync \
  -H "Authorization: Bearer {access_token}"

Sync Endpoint

GET

/dapodik/sync

Trigger sinkronisasi Dapodik

▶

Sinkronisasi data dari server Dapodik sekolah. Tanpa parameter entities, sinkronisasi semua data utama (sekolah, siswa, guru, kelas).

Parameter	Type	Description
entities	string	Koma-separated entity: `schools,students,teachers,classes,subjects,infrastructure` atau `all`

Response 200

{
  "message": "Sync completed.",
  "results": {
    "schools": { "status": "success", "count": 1 },
    "students": { "status": "success", "count": 847 },
    "teachers": { "status": "success", "count": 62 },
    "classes": { "status": "success", "count": 24 }
  },
  "last_sync": "2026-10-08T14:30:00+07:00"
}

🧪 Try It

Access Token entities (opsional)

Sync Status

GET

/dapodik/status

Status sinkronisasi terakhir

▶

Cek status dan log sinkronisasi terakhir untuk sekolah ini.

Students

GET

/dapodik/students

List siswa dari Dapodik

▶

Ambil data siswa yang sudah di-sync dari Dapodik. Tenant-scoped otomatis.

Parameter	Type	Description
search	string	Cari berdasarkan nama
gender	string	`L` atau `P`
nisn	string	Filter by NISN
per_page	integer	Jumlah per halaman (default: 25)

🧪 Try It

Access Token

Teachers

GET

/dapodik/teachers

List guru dari Dapodik

▶

Ambil data PTK (Guru, Kepala Sekolah, TU) yang sudah di-sync.

Parameter	Type	Description
search	string	Cari berdasarkan nama
jenis_ptk	string	Jenis PTK: `guru`, `kepala_sekolah`, `tu`

Classes

GET

/dapodik/classes

List kelas / rombel

▶

Ambil data rombongan belajar (rombel) beserta wali kelas.

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

Data Schema — Students

Field yang tersedia di endpoint /dapodik/students:

Field	Type	Description
id	integer	ID lokal
peserta_didik_id	string	ID dari Dapodik
nisn	string(10)	Nomor Induk Siswa Nasional
nis	string	Nomor Induk Sekolah
nik	string(16)	NIK (dari KTP)
nama	string	Nama lengkap
jenis_kelamin	string	`L` atau `P`
tanggal_lahir	date	Format: YYYY-MM-DD
tempat_lahir	string	Kota lahir
alamat	string	Alamat lengkap
kabupaten_kota	string	Kabupaten/Kota
nama_ayah	string	Nama ayah
nama_ibu	string	Nama ibu
dapodik_synced_at	datetime	Waktu sinkronisasi terakhir