Lewati ke konten utama

Dokumentasi API Layanan

Layanan API digunakan untuk mengintegrasikan data civitas akademika dengan berbagai aplikasi dan sistem informasi di lingkungan Politeknik Negeri Batam.

:::info Pengelolaan Akses API Saat ini, seluruh integrasi, perizinan, dan penyediaan kredensial API dikelola secara terpusat oleh UPA-TIK (Unit Penunjang Akademik Teknologi Informasi dan Komunikasi) Polibatam. :::

Prosedur Pengajuan Akses melalui Helpdesk​

Bagi pengembang sistem, unit kerja, atau pihak yang memerlukan akses dan integrasi data civitas, silakan mengajukan permohonan melalui portal resmi Helpdesk Polibatam:

👉 https://helpdesk.polibatam.ac.id/

Langkah-langkah Pembuatan Tiket:​

  1. Buka Laman Helpdesk: Kunjungi tautan https://helpdesk.polibatam.ac.id/.
  2. Buka Tiket Baru: Klik tombol Open a New Ticket.
  3. Pilih Departemen: Pada kolom pilihan Department, pilih UPA TIK.
  4. Isi Informasi & Rincian Kebutuhan:
    • Nama Aplikasi / Sistem: Sistem yang akan dibangun atau diintegrasikan.
    • Unit Kerja & Penanggung Jawab: Nama unit kerja serta kontak PIC teknis.
    • Kebutuhan Data: Jenis endpoint data civitas yang dibutuhkan (misal: data mahasiswa aktif, data staf/dosen, atau kebutuhan autentikasi SSO).
    • Tujuan Penggunaan: Uraian singkat tujuan integrasi data tersebut.
  5. Kirim Tiket: Periksa kembali kelengkapan formulir lalu kirimkan tiket Anda.
  6. Pemberian Kredensial: Setelah permohonan diverifikasi dan disetujui oleh pihak UPA-TIK, Anda akan diberikan kredensial akses berupa apiKey dan secret.

:::warning Pastikan Alamat Email Aktif Pastikan email yang Anda cantumkan dalam keadaan aktif, karena seluruh konfirmasi, tanggapan, dan balasan teknis dari petugas UPA-TIK akan dikirimkan langsung melalui email tersebut. :::

:::tip Pemantauan Progres Tiket Anda juga dapat melakukan Register / Mendaftar Akun di portal Helpdesk terlebih dahulu untuk memudahkan Anda dalam melacak (tracking) status dan perkembangan tiket pengajuan secara berkala di dashboard akun Anda. :::

Base URL​

Layanan API data civitas dapat diakses melalui endpoint berikut:

https://service.polibatam.ac.id/civitas/

:::note Catatan Penggunaan Setelah permohonan disetujui oleh UPA-TIK, Anda akan diberikan kredensial akses berupa apiKey dan secret. Pastikan setiap request yang dikirimkan menyertakan header otentikasi dengan kredensial tersebut serta format data yang telah ditetapkan sesuai arahan teknis dari UPA-TIK. :::