MULAI DI SINI

Token API untuk Integrasi: Token Pribadi dan Akun Layanan

Dua cara memberi sistem lain akses REST API ke data LSP — token pribadi dari halaman Profil dan token akun layanan yang diterbitkan admin — beserta izinnya, masa berlaku, cara mencabut, dan data yang bisa diambil.

Selain aplikasi mobile, REST API NeoSerti bisa dipakai sistem lain — situs mitra yang menampilkan katalog skema, sistem informasi lembaga induk, atau skrip laporan — untuk mengambil data LSP. Sistem seperti itu tidak masuk lewat peramban; ia memakai token yang diterbitkan dari NeoSerti. Ada dua jenis, dan keduanya tunduk pada aturan yang sama.

Aturan yang berlaku untuk keduanya

  • Saklar Feature Api harus menyala, dan peran yang dibawa token harus memegang izin Use Api — lihat Menghubungkan Aplikasi Mobile.
  • Token terikat ke satu peran dan hanya membawa hak peran itu. Ia tidak bisa dipindah ke peran lain.
  • Masa berlaku dipilih saat membuat: 30 hari, 90 hari (bawaan), 180 hari, atau 1 tahun. Token tidak bisa diperpanjang; setelah habis, buat token baru.
  • Token hanya ditampilkan sekali, sesaat setelah dibuat. Salin dengan tombol Salin token dan simpan langsung di sistem yang memakainya. Bila terlewat, cabut dan buat ulang.
  • Token tidak bisa dibuat selama impersonate, dan tidak bisa dibuat atas nama akun Super Admin maupun akun nonaktif.

Token pribadi

Token pribadi dibuat pengguna sendiri, untuk skrip atau sistem yang bekerja atas nama akunnya. Ia butuh izin tambahan Buat Token Api pada peran yang sama — izin yang tidak dipegang peran mana pun secara bawaan, supaya pemakai aplikasi mobile tidak otomatis bisa mencetak token berumur panjang.

  1. Buka Profil dari menu akun, bagian Perangkat & Token API.
  2. Tekan Buat token.
  3. Isi Nama token supaya mudah dikenali di daftar, pilih Peran, dan pilih Berlaku selama.
  4. Salin token yang tampil, lalu tempelkan ke sistem yang memakainya.

Token pribadi ikut tercantum di daftar Perangkat & Token API dengan jenis Token pribadi, dan dicabut dengan tombol Cabut yang sama. Mencabut izin Buat Token Api dari sebuah peran hanya menghentikan pembuatan token baru — token yang sudah terbit tetap bekerja. Untuk menghentikannya, cabut tokennya di Profil pemiliknya, atau cabut izin Use Api dari perannya.

Akun layanan

Untuk integrasi yang tidak mewakili orang tertentu, pakai akun layanan: akun khusus sistem yang tidak pernah bisa masuk ke panel mana pun, termasuk lewat masuk dengan Google.

  1. Siapkan peran untuk integrasi itu dengan izin Use Api dan izin data seminimal mungkin. Jangan memakai peran Admin LSP untuk sistem luar.
  2. Buka Pengaturan → Users, lalu tekan Buat akun layanan.
  3. Isi Nama dan Username, lalu centang Peran. Hanya peran ber-izin Use Api yang ditawarkan. Email akun dibuat otomatis dari username, dan kata sandinya acak.
  4. Anda diantar ke halaman detail akun itu. Di bagian Token API, tekan Terbitkan token, isi Nama token, Peran, dan Berlaku selama, lalu salin tokennya.

Menerbitkan dan mencabut token akun layanan butuh izin Kelola Token Layanan — terpisah dari izin mengelola pengguna, dan tidak dipegang peran mana pun secara bawaan; Super Admin tetap bisa. Bagian Token API mendaftar setiap token beserta siapa penerbitnya, dengan tombol Cabut per token dan Cabut semua token. Bagian itu juga memberi tahu bila REST API sedang mati, atau bila akun belum memegang peran ber-izin Use Api.

Di daftar Users, akun layanan diberi penanda dan bisa disaring dengan Akun Layanan. Reset kata sandi dan impersonate tidak berlaku bagi akun ini.

Data yang bisa diambil sistem lain

Semuanya mengikuti izin peran yang dibawa token, persis seperti di panel:

  • Katalog LSP — skema, unit kompetensi, dan TUK. Hanya dibaca, tidak diubah.
  • Kegiatan dan pesertanya. Daftar peserta hanya terisi bagi peran yang memegang Lihat Seluruh Asesmen.
  • Asesmen dan jadwal sertifikasi, dengan batas cakupan yang sama dengan panel.
  • Asesi — biodata, kontak, alamat sesuai KTP, dan status pendaftarannya, tanpa NIK. Cakupannya sama dengan daftar Asesi di panel: pemegang Lihat Seluruh Asesmen mendapat seluruh LSP, asesor hanya asesi yang ia asesori. Bisa disaring menurut status pendaftaran atau kegiatan.
  • Asesor — No. Reg MET, nama, email, nomor HP, sertifikat asesor, dan sertifikat teknis beserta masa berlakunya, tanpa NIK, tanggal lahir, maupun alamat. Cakupannya sama dengan daftar Asesor di panel: hanya pemegang Lihat Seluruh Asesmen yang mendapat seluruh asesor; akun asesor hanya mendapat barisnya sendiri. Bisa disaring menurut No. Reg MET atau kegiatan.
  • Data keuangan — tagihan, pembayaran, jenis tagihan, tarif, dan refund — hanya dibaca, selama modul Keuangan menyala.

Katalog, asesi, asesor, dan data keuangan bisa diambil sebagian, yaitu hanya yang berubah sejak pengambilan terakhir, sehingga sistem lain cukup menyinkronkan perubahan secara berkala. Perubahan pada sertifikat teknis tidak terhitung sebagai perubahan data asesornya, jadi sistem yang membutuhkan sertifikat teknis terkini sebaiknya sesekali mengambil ulang seluruh daftar asesor.

[Gambar — bagian Token API di halaman detail akun layanan dengan tombol Terbitkan token]

Tertarik memakai NeoSerti untuk LSP Anda?

Ceritakan kebutuhan lembaga sertifikasi Anda — tim kami akan menghubungi Anda kembali.

FORM KONTAK · DEMO & INFO
RESPON TIM SALES < 1 × 24 JAM KERJA
Dilindungi reCAPTCHA — Privasi & Ketentuan Google berlaku.