API Access untuk Partner
Menu: API Access. Halaman Third-Party API Access digunakan administrator untuk mengelola token partner atau aplikasi yang mengambil data peserta lunas melalui API read-only. Token ini tidak menggantikan akun login dashboard panitia.
Membaca daftar token
| Kolom | Kegunaan |
|---|---|
| Name | Nama partner atau aplikasi pemegang akses |
| Prefix | Potongan awal token untuk mengenali token; bukan token lengkap |
| Status | Active atau Inactive |
| Event Access | Event yang diizinkan atau Semua event dalam tenant |
| Expires | Batas masa berlaku token jika ditentukan |
| Last Used | Waktu pemakaian terakhir yang tercatat |
| Actions | Edit, Disable/Enable, Rotate, dan Revoke |
Gunakan pencarian berdasarkan partner atau prefix serta filter status untuk menemukan akses yang akan diperiksa. Status Active tetap perlu dibaca bersama tanggal kedaluwarsa dan izin event.
Membuat token
- Klik Buat Token.
- Isi Nama partner / aplikasi, misalnya nama penyedia layanan yang bekerja sama dengan penyelenggara.
- Isi Expires at untuk akses yang hanya diperlukan sementara, atau biarkan kosong sesuai kebijakan kerja sama.
- Pada Event yang diizinkan, pilih event yang diperlukan partner.
- Klik Simpan Token dan tunggu konfirmasi.
- Salin token lengkap ketika pertama ditampilkan menggunakan Copy dan simpan dengan aman.
- Berikan token kepada penanggung jawab integrasi melalui saluran yang disetujui tim, lalu minta mereka memeriksa akses pada event yang diizinkan.
Daftar event yang dikosongkan berarti semua event dalam tenant tersebut, bukan tidak mendapat akses. Token lengkap hanya tampil setelah dibuat atau dirotasi. Prefix pada tabel tidak dapat dipakai sebagai pengganti token lengkap. Jangan menaruh token di screenshot atau panduan publik.
Memilih tindakan yang tepat
| Tindakan | Kapan digunakan | Hasil |
|---|---|---|
| Edit | Mengubah nama, tanggal kedaluwarsa, atau daftar event yang boleh dibaca | Memperbarui pengaturan akses token yang sama |
| Disable | Menghentikan akses sementara | Status menjadi Inactive; dapat diaktifkan kembali melalui Enable |
| Enable | Membuka kembali token yang dinonaktifkan | Status menjadi Active; masa berlaku dan izin event tetap perlu diperiksa |
| Rotate | Mengganti rahasia token, misalnya saat penggantian kredensial partner | Token baru diterbitkan dan token lama tidak dapat digunakan lagi |
| Revoke | Mencabut akses yang sudah tidak digunakan | Token dicabut secara permanen setelah konfirmasi |
Mengedit izin
Klik Edit pada partner yang benar, sesuaikan pengaturan, lalu Simpan Token. Periksa kembali kolom Event Access dan Expires. Saat mengurangi cakupan, informasikan event mana yang masih dapat dibaca kepada partner.
Mengganti token dengan Rotate
Klik Rotate, baca konfirmasi bahwa token lama akan berhenti berlaku, lalu lanjutkan jika sudah siap. Salin token baru saat ditampilkan dan perbarui konfigurasi aplikasi partner. Periksa pemakaian setelah pergantian. Mengedit izin tidak sama dengan menerbitkan token baru.
Mencabut atau menghentikan akses
Gunakan Disable untuk penghentian sementara. Gunakan Revoke untuk pencabutan permanen dan pastikan nama partner pada konfirmasi benar. Jangan memilih Revoke hanya untuk mengubah nama atau tanggal kedaluwarsa.
Jika partner tidak bisa mengakses data
Periksa status token, waktu kedaluwarsa, event yang diizinkan, serta apakah partner masih memakai token lama setelah Rotate. Data yang belum lunas tidak termasuk tujuan akses API ini. Gunakan nama partner, prefix, waktu kejadian, dan pesan kesalahan saat berkoordinasi; jangan menyalin token lengkap ke laporan masalah.
Untuk pengaturan aplikasi, layanan publik, dan notifikasi, kembali ke Pengaturan Sistem dan Integrasi.
