Skip to main content

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.

Third-Party API Access dengan daftar partner, prefix token, status, akses event, kedaluwarsa, waktu terakhir dipakai, dan aksi Edit Disable Rotate Revoke

Membaca daftar token​

KolomKegunaan
NameNama partner atau aplikasi pemegang akses
PrefixPotongan awal token untuk mengenali token; bukan token lengkap
StatusActive atau Inactive
Event AccessEvent yang diizinkan atau Semua event dalam tenant
ExpiresBatas masa berlaku token jika ditentukan
Last UsedWaktu pemakaian terakhir yang tercatat
ActionsEdit, 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​

  1. Klik Buat Token.
  2. Isi Nama partner / aplikasi, misalnya nama penyedia layanan yang bekerja sama dengan penyelenggara.
  3. Isi Expires at untuk akses yang hanya diperlukan sementara, atau biarkan kosong sesuai kebijakan kerja sama.
  4. Pada Event yang diizinkan, pilih event yang diperlukan partner.
  5. Klik Simpan Token dan tunggu konfirmasi.
  6. Salin token lengkap ketika pertama ditampilkan menggunakan Copy dan simpan dengan aman.
  7. Berikan token kepada penanggung jawab integrasi melalui saluran yang disetujui tim, lalu minta mereka memeriksa akses pada event yang diizinkan.
Cakupan event dan penyimpanan token

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​

TindakanKapan digunakanHasil
EditMengubah nama, tanggal kedaluwarsa, atau daftar event yang boleh dibacaMemperbarui pengaturan akses token yang sama
DisableMenghentikan akses sementaraStatus menjadi Inactive; dapat diaktifkan kembali melalui Enable
EnableMembuka kembali token yang dinonaktifkanStatus menjadi Active; masa berlaku dan izin event tetap perlu diperiksa
RotateMengganti rahasia token, misalnya saat penggantian kredensial partnerToken baru diterbitkan dan token lama tidak dapat digunakan lagi
RevokeMencabut akses yang sudah tidak digunakanToken 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.