Human Token

Human Token dirancang untuk skenario di mana tidak ada hubungan dengan dokumen yang dikeluarkan pemerintah — situasi di mana pelanggan ingin menghindari berbagi nomor dokumen karena alasan privasi. Fungsi utamanya adalah membuat identitas unik untuk setiap wajah dari satu kali pengiriman selfie.

Ini memungkinkan Anda untuk:

• Mendeteksi pengguna yang berulang dan mencegah akun duplikat — mengenali apakah orang yang sama sedang kembali atau mencoba membuat beberapa akun, memastikan pengenalan identitas yang konsisten tanpa dokumen resmi.
• Berintegrasi melalui Web, Native, atau API — hanya menggunakan gambar selfie sebagai input, tanpa data dokumen tambahan yang diperlukan.
• Menggabungkan dengan sinyal lain — tambahkan Human Token bersama kemampuan lain sesuai kebutuhan.

Apa yang dilakukannya

Dari selfie yang diambil, Human Token menghasilkan pengenal biometrik buram yang stabil (personId) yang secara unik mewakili wajah tersebut. Pengguna tidak menyatakan pengenal apa pun — identitas adalah output dari panggilan, bukan input. Pada setiap pencocokan yang berhasil, respons mengembalikan personId yang sama, sehingga pengguna yang sama dapat dikenali dalam proses-proses berikutnya.

Input

Selfie diambil oleh SDK atau Web Journey. Untuk integrasi API tanpa SDK, gambar dikirim sebagai imagebase64 di dalam body POST /processes/v1. Jangan sertakan subject.code — Human Token mengembalikan personId dalam respons.

SDK diperlukan untuk pengambilan berkualitas

Untuk memastikan gambar yang dikirim melalui API memenuhi persyaratan biometrik, gunakan Unico SDK untuk platform Anda atau ikuti Standar Pengambilan. Human Token tidak menerima gambar sembarangan tanpa kontrol kualitas pengambilan.

Kemungkinan respons

idFace.result	Makna
FOUND	Identitas berhasil ditentukan. personId dikembalikan dan terisi.

Ketika tidak ada personId yang dapat dihasilkan

Hanya ada satu skenario di mana Human Token tidak menghasilkan personId: wajah tidak dapat diidentifikasi dalam gambar yang dikirim — tidak ada wajah yang terdeteksi, kualitas gambar terlalu rendah, atau wajah berada di luar standar pengambilan (miring, menghadap ke samping). Ini bukan nilai result: permintaan gagal dengan 20532 — No face detected in image. Mengikuti Standar Pengambilan adalah yang mencegah hal ini.

Contoh respons

{
  "id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
  "status": 3,
  "idFace": {
    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "result": "FOUND"
  }
}

personId adalah pengenal buram yang stabil — pengguna yang sama akan selalu menghasilkan nilai yang sama. Simpan bersama catatan pengguna Anda untuk mengenali orang yang sama pada panggilan Human Token berikutnya.

Ketersediaan

Permukaan	Didukung
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅
API (tanpa SDK)	✅