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”.

Screenshot 2023-08-14 105341.png

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

Picture1.png

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”.

Picture2.png

6. Klik tombol ‘Kredensial API’.

Kredensial API.png

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

sister ws basic.png

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’.