Tutorial Integrasi API Manager BKN

Tujuan

Panduan mengelola integrasi dengan API BKN (Badan Kepegawaian Negara) untuk sinkronisasi data kepegawaian ASN — mengatur credential, memantau sinkronisasi, dan troubleshooting koneksi.

1. Akses API Manager BKN

Masuk ke menu Integrasi → API Manager BKN pada sidebar kiri atau buka langsung:

/org/api-manager-siasn

Halaman ini adalah pusat pengelolaan koneksi ke layanan SIASN BKN.

2. Informasi yang Ditampilkan

• Status Koneksi — Terhubung / Terputus / Error
• Pengaturan Credential — input Consumer Key, Consumer Secret, dan endpoint API BKN
• Riwayat Sinkronisasi — log hasil sinkronisasi data terbaru
• Tombol Uji Koneksi — untuk memvalidasi kredensial yang dimasukkan
• Tombol Sinkronisasi — menjalankan sinkronisasi data pegawai dari BKN

3. Tab Koneksi — Mengatur Credential

Tab ini digunakan untuk mengelola kredensial koneksi ke API BKN:

1. Masukkan Consumer Key pada field yang tersedia.
2. Masukkan Consumer Secret pada field yang tersedia.
3. Pilih Endpoint (produksi atau sandbox).
4. Klik Simpan untuk menyimpan kredensial.

4. Uji Koneksi

Setelah menyimpan credential, klik tombol Uji Koneksi untuk memverifikasi:

• Apakah credential valid?
• Apakah endpoint BKN dapat dijangkau?
• Apakah token akses berhasil didapatkan?

Hasil uji koneksi akan ditampilkan sebagai notifikasi sukses atau pesan error. Status koneksi akan muncul di halaman: Terhubung, Terputus, atau error.

5. Tab Mapping — Preview & Push Absensi ke SIASN

Tab ini adalah pusat pengelolaan data absensi yang akan dikirim ke SIASN BKN:

5.1 Preview Payload

Sebelum mengirim data, Anda bisa melihat pratinjau payload absensi yang akan dikirim:

• Klik tombol Preview untuk melihat contoh data absensi dalam format JSON.
• Data yang ditampilkan adalah sampel absensi pegawai yang akan dikirim ke BKN.
• Gunakan fitur Copy untuk menyalin payload ke clipboard.

5.2 Dry-Run Push

Simulasi pengiriman data tanpa benar-benar mengirim ke server BKN:

• Klik tombol Dry-Run Push untuk mensimulasikan pengiriman.
• Sistem akan memproses data seperti pengiriman sungguhan tapi tidak mengirim ke endpoint BKN.
• Hasil simulasi menunjukkan apakah data akan berhasil atau gagal jika dikirim.

5.3 Push Live

Mengirim data absensi secara langsung ke server SIASN BKN:

1. Pastikan koneksi berstatus Terhubung.
2. Klik tombol Push untuk mengirim data absensi ke BKN.
3. Proses berjalan di latar belakang — hasilnya akan muncul sebagai notifikasi.

6. Tab Sync Log — Riwayat Sinkronisasi

Tab ini menampilkan log dari semua operasi sinkronisasi yang pernah dilakukan:

• Waktu — tanggal dan jam sinkronisasi dijalankan
• Status — sukses, gagal, atau berjalan
• Detail — jumlah data yang berhasil/tidak tersinkron
• Pesan Error — informasi jika terjadi kegagalan

Gunakan tombol Refresh untuk memuat ulang log terbaru.

7. Tab Runbook — Panduan Operasional

Tab ini berisi panduan langkah demi langkah untuk operasional API Manager BKN, termasuk:

• Prosedur inisialisasi koneksi pertama kali
• Alur kerja sinkronasi data harian
• Penanganan error umum dan cara mengatasinya
• Best practices untuk menjaga koneksi tetap stabil

Runbook berguna sebagai referensi cepat untuk operator yang mengelola integrasi BKN.

8. Troubleshooting