Mendaftarkan Orang

Pendaftaran mengubah foto seseorang menjadi template wajah, sehingga orang itu dapat dikenali di kemudian hari. Foto tidak disimpan.

Foto Pendaftaran Yang Baik

• Hanya orang ini di dalam foto, menghadap kamera (kepala menoleh dan miring kurang dari 15 derajat).
• Seluruh wajah terlihat, dari dahi sampai dagu: tanpa kacamata hitam atau masker. Kacamata bening dan penutup kepala tidak masalah.
• Mata terbuka, ekspresi netral, cahaya merata, tajam, dengan tinggi wajah minimal 112 piksel. Foto ponsel sejarak lengan sudah cukup.
• Dua sampai lima foto orang yang sama memberi hasil yang lebih baik daripada satu foto.

Foto yang tidak memenuhi syarat ini ditolak beserta alasannya, misalnya POSE_YAW (kepala menoleh) atau UNEVEN_LIGHT, dan apa yang perlu diubah.

Di Dasbor

1. Buka People lalu pilih Enrol a person.
2. ID for this person: referensi Anda sendiri, misalnya nomor karyawan (huruf, angka dan . _ : @ -). Jangan memakai nomor identitas kependudukan.
3. Name shown in the dashboard: opsional.
4. Tambahkan satu sampai lima foto: Upload, Camera (webcam peramban) atau Use a test photo untuk mencobanya.
5. Centang bahwa orang tersebut telah diberi tahu tujuannya dan menyetujuinya, lalu pilih Enrol.

Dengan API

curl -X POST http://localhost:8080/v2/identities \
  -H "x-api-key: $API_KEY" \
  -F uid=emp-1042 -F display_name="Mei Tanaka" \
  -F image=@mei-1.jpg -F image2=@mei-2.jpg

import requests
r = requests.post("http://localhost:8080/v2/identities",
                  headers={"x-api-key": API_KEY},
                  data={"uid": "emp-1042", "display_name": "Mei Tanaka"},
                  files={"image": open("mei-1.jpg", "rb"), "image2": open("mei-2.jpg", "rb")})
print(r.status_code, r.json())

Key memerlukan izin enrol.

Duplikat

Bila wajah sudah terdaftar dengan ID lain, pendaftaran menjawab 409 POSSIBLE_DUPLICATE. Key yang juga boleh mencari (identify) melihat ID mana yang cocok. Admin tetap dapat mendaftarkannya dengan force=true.

Tingkat Ketatnya Pendaftaran

Settings, Enrolment photo rules menentukan seberapa ketat pemeriksaan foto untuk organisasi Anda: Standard (bawaan), Passport (lebih ketat, seperti foto paspor) atau CCTV (menerima cuplikan kamera, dengan akurasi lebih rendah). Di API: enrol pada PATCH /v2/tenant/policy.

Menghapus Orang

Delete di halaman orang tersebut, atau DELETE /v2/identities/{uid}, menghapus orang itu beserta semua templatenya sekaligus, dan mencatat penghapusan di log audit.