Informasi API SISTER (Versi Cloud)

API SISTER dibutuhkan hanya untuk Perguruan Tinggi (PT) yang memiliki sistem aplikasi kampus atau sistem kepegawaiannya sendiri. Dengan mengimplementasikan API SISTER, dosen hanya perlu memasukkan data di satu sistem saja dan data yang tadinya berada di luar SISTER dapat diintegrasikan ke dalam SISTER (versi Cloud).

Data yang dapat diintegrasikan menggunakan API SISTER yaitu: 

• Data Kepegawaian
• Data Tridharma (Pendidikan dan Pengajaran, Penelitian dan Pengembangan, dan Pengabdian Kepada Masyarakat)
• Data Publikasi
• Data Jabatan
• Data Sertifikasi Dosen
• Data Sertifikasi Profesi
• dan lainnya. 

Semua data di atas dapat dilihat, ditambahkan, dan diubah melalui API SISTER yang sudah diintegrasikan dengan aplikasi PT.

Saat ini, SISTER memiliki 2 endpoint, yaitu:

• Endpoint Sandbox: sister-api.kemdikbud.go.id/ws-sandbox.php/1.0
• Endpoint Production: sister-api.kemdikbud.go.id/ws.php/1.0 

Catatan: Sandbox dapat digunakan untuk percobaan sebelum diimplementasikan di production.

Tahapan 1

Cara Mendapat Akses ke API SISTER

Untuk mendapatkan akses ke API SISTER, pihak terkait harus memiliki akun dan mendapatkan token untuk aksesnya. Berikut panduannya: 

1. Pihak terkait yang akan mengimplementasikan API SISTER meminta Admin Perguruan Tinggi untuk menambahkan pengguna atau edit peran di Manajemen Akses.

2. Admin PT mengakses Manajemen Akses. Kemudian pada bagian peran pengguna terkait, harap untuk memilih peran “Sister WS Basic”.

3. Setelah penambahan pengguna atau penambahan peran dilakukan, username dan password untuk akses ke SISTER akan dikirimkan melalui email pengguna tersebut.

4. Jika sudah, pihak terkait dapat login ke akun SISTER menggunakan username dan password yang telah dikirimkan melalui email sebelumnya.

5. Pastikan sudah memilih peran di Beranda SISTER sebagai “SISTER WS-Basic”.

6. Klik tombol ‘Kredensial API’.

7. Temukan informasi:  username, password, dan id_pengguna yang siap digunakan sebagai penyusun data JSON untuk mengakses API SISTER.

Catatan: Jika Anda sebelumnya sudah didaftarkan ke dua peran yaitu SISTER WS-Basic dan Developer, silakan gunakan peran SISTER WS-Basic untuk proses implementasi API SISTER.

Token

Untuk dapat melakukan request data di SISTER, dibutuhkan Token sebagai autentikasi pengguna. Token didapatkan menggunakan API Authorize dengan parameter username, password, dan id_pengguna. Setelah mendapatkan response, token dapat digunakan selama 60 menit, dan pengguna diharuskan melakukan request ulang untuk sesi berikutnya.

Contoh request:

Contoh response:

Autentikasi

Setelah mendapatkan Token, pengguna dapat menggunakan Token tersebut untuk parameter Authorization pada header request diawali dengan “Bearer “.
Contoh: 

Tahapan 2

Di tahapan 2, Anda dapat memulai dengan mengambil data pegawai di perguruan tinggi terlebih dahulu karena di beberapa API membutuhkan id_sdm sebagai parameter request utama.

Data Pegawai di Perguruan Tinggi

Pada API Pegawai di Perguruan Tinggi, ada 4 parameter request yang dapat digunakan: id_sp, nama, nidn, nip. Untuk melakukan pencarian data pegawai, cukup menggunakan salah satu dari parameter yang tersedia. Pada umumnya, Perguruan Tinggi menggunakan nama atau NIDN untuk mencari data pegawai. Berikut contoh respon menggunakan parameter nama.

Setelah mendapatkan id_sdm, pengguna bisa menggunakan value id_sdm pada daftar API di bawah ini:

1. Dokumen
2. Data pokok
3. Inpassing
4. Jabatan fungsional
5. Kepangkatan
6. Penugasan
7. Pengajaran
8. Bimbingan mahasiswa
9. Pengujian mahasiswa
10. Datasering
11. Orasi ilmiah
12. Bahan ajar
13. Bimbingan dosen
14. Tugas tambahan
15. Penelitian
16. Publikasi
17. Kekayaan intelektual
18. Pengabdian
19. Pembicara
20. Jabatan struktural
21. Anggota profesi
22. Pengelola jurnal
23. Penghargaan
24. Visiting scientist
25. Penunjang lain
26. Pendidikan formal
27. Diklat
28. Riwayat pekerjaan
29. Sertifikat profesi
30. Sertifikasi dosen
31. Tes
32. Beasiswa
33. Kesejahteraan
34. Tunjangan 

Tahapan 3

Jika Anda sudah bisa melakukan autentikasi API melalui tahapan 1 dan mendapatkan data pegawai di tahapan 2, Anda dapat melanjutkan integrasi API yang tersedia di SISTER API sesuai dengan kebutuhan. Namun, apabila Anda membutuhkan bantuan pendampingan dalam proses integrasi, Anda dapat membuat surat pengajuan pendampingan integrasi SISTER API tertuju ke pihak Datin.

Dokumen referensi lengkap terkait API SISTER dapat dibaca pada laman berikut: https://sister-api.kemdikbud.go.id/ws.php/1.0#overview.

Apabila mengalami kendala terkait API SISTER, silakan laporkan kendala beserta tangkapan layar (screenshot), jika ada melalui tombol ‘Pusat Bantuan’.