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:
- Dokumen
- Data pokok
- Inpassing
- Jabatan fungsional
- Kepangkatan
- Penugasan
- Pengajaran
- Bimbingan mahasiswa
- Pengujian mahasiswa
- Datasering
- Orasi ilmiah
- Bahan ajar
- Bimbingan dosen
- Tugas tambahan
- Penelitian
- Publikasi
- Kekayaan intelektual
- Pengabdian
- Pembicara
- Jabatan struktural
- Anggota profesi
- Pengelola jurnal
- Penghargaan
- Visiting scientist
- Penunjang lain
- Pendidikan formal
- Diklat
- Riwayat pekerjaan
- Sertifikat profesi
- Sertifikasi dosen
- Tes
- Beasiswa
- Kesejahteraan
- 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’.