Langsung ke konten utama
POST
curl
Unggah gambar wajah yang dienkode base64 ke daftar blokir atau daftar izin wajah. Didit mendeteksi wajah dalam gambar, mempertahankan wajah yang paling besar, menyimpan gambar dan potongan wajah tersebut, lalu menghitung templat biometrik wajah yang menjadi pembanding bagi sesi baru. Nilai value dari entri baru adalah UUID wajah tersebut. Hanya tersedia untuk daftar dengan entry_type: face dan list_type: blocklist atau list_type: allowlist.
Jika Anda ingin memasukkan wajah dari sesi yang sudah ada ke daftar blokir atau daftar izin, gunakan Buat entri dengan reference_session_id sebagai gantinya: entri tersebut akan tertaut kembali ke sesinya.
Gambar harus memuat wajah yang terlihat jelas dan berukuran maksimal 2 MB setelah didekode. Jika tidak ada wajah yang terdeteksi, permintaan mengembalikan 400 dan tidak ada entri yang dibuat. Jika analisis wajah untuk sementara tidak tersedia, permintaan mengembalikan 503: coba lagi nanti.
Untuk menghapus wajah dari daftar, hapus entrinya: wajah tersebut tidak lagi dicocokkan dengan sesi baru.

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Parameter Path

list_uuid
string<uuid>
wajib

UUID dari daftar dengan entry_type: face dan list_type: blocklist atau allowlist.

Body

application/json
image
string<byte>
wajib

JPEG atau PNG yang di-encode Base64, maksimal 2 MB setelah didecode, menampilkan wajah yang terlihat jelas. Kirim string base64 mentah, tanpa awalan data:image/...;base64,.

comment
string
default:""

Catatan teks bebas opsional, seperti alasan pencantuman.

Respons

Entri wajah telah dibuat.

Satu nilai dalam sebuah daftar.

uuid
string<uuid>
wajib

Pengidentifikasi entri. Gunakan sebagai entry_uuid dalam operasi Hapus entri daftar.

value
string
wajib

Nilai yang terdaftar: nomor telepon dalam format E.164, alamat email, nomor dokumen, alamat IP atau rentang CIDR, sidik jari perangkat, alamat dompet, rekening bank, kode negara ISO 3166-1 alpha-3, vendor_data, string apa pun pada daftar key, atau UUID wajah yang disimpan pada daftar wajah. Nilai yang Anda kirim disimpan dalam huruf kecil, kecuali nomor telepon dan kode negara. Pencocokan tidak membedakan huruf besar dan kecil.

display_label
string | null
wajib

Label yang mudah dibaca manusia. Didit mengisinya untuk entri yang diambil dari sesi (misalnya nama pemegang dan nomor dokumen) saat Anda tidak mengirimkannya.

Maximum string length: 512
comment
string
wajib

Catatan teks bebas. String kosong jika tidak diatur.

added_by
string | null
wajib

Pihak yang menambahkan entri: api (kunci API), alamat email pengguna konsol atau console, system atau migration (entri yang dibuat Didit), atau rule (tindakan aturan transaksi atau aturan pemantauan).

reference_session_id
string<uuid> | null
wajib

Sesi verifikasi tempat entri tersebut diambil. null jika entri ditambahkan berdasarkan nilai.

reference_session_number
integer | null
wajib

Nomor sesi tersebut dalam cakupan aplikasi, seperti yang ditampilkan di konsol.

reference_session_type
enum<string> | null
wajib

kyc untuk sesi verifikasi perorangan, kyb untuk sesi verifikasi bisnis, null ketika tidak ada sesi.

Opsi yang tersedia:
kyc,
kyb,
null
reference_object_uuid
string<uuid> | null
wajib

Rekaman yang diwakili oleh entri: rekaman wajah, dokumen, telepon, atau email yang dibaca dari sesi, wajah yang dibuat melalui Unggah wajah ke daftar, atau UUID yang Anda kirim (misalnya UUID transaksi atau didit_internal_id milik pengguna).

metadata
object | null
wajib

Konteks tambahan. Berisi kunci yang ditetapkan Didit (tercantum di sini) yang digabungkan dengan metadata apa pun yang Anda kirimkan saat membuat entri, dikembalikan seperti yang disimpan. null jika tidak ada.

created_at
string<date-time>
wajib

Waktu ketika entri ditambahkan.

Terakhir diubah pada 7 November 2026