Langsung ke konten utama
POST
cURL

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.

Body

multipart/form-data
user_image
file
wajib

Gambar wajah menghadap ke depan (misalnya swafoto). Ekstensi yang diizinkan: tiff, jpg, jpeg, png, webp. Ukuran unggahan maksimum: 5 MB (file yang lebih besar ditolak dengan 400). Gambar otomatis dikompresi menjadi ~0.5 MB sebelum diproses, sehingga resolusi yang sangat tinggi tidak meningkatkan akurasi. Gambar harus memuat satu subjek — jika terdapat beberapa wajah, wajah terbesar yang akan dievaluasi dan peringatan MULTIPLE_FACES_DETECTED ditambahkan.

face_liveness_score_decline_threshold
number<float>
default:30

Ambang batas skor liveness (0–100). Skor terhitung pada atau di bawah nilai ini mengeluarkan peringatan LOW_LIVENESS_SCORE dan menetapkan status ke Declined. Default 30; naikkan untuk postur anti-spoofing yang lebih ketat. Nilai di luar 0–100 mengembalikan 400.

Rentang yang diperlukan: 0 <= x <= 100
Contoh:

30

rotate_image
boolean
default:false

Jika true, layanan mencoba rotasi 90 derajat dari input dan menggunakan orientasi yang menghasilkan deteksi wajah terbaik. Berguna saat orientasi EXIF tidak ada. Menambah latensi.

Contoh:

false

save_api_request
boolean
default:true

Jika true (default), menyimpan panggilan sebagai sesi tipe API, menyimpan gambar wajah, memancarkan webhook status.updated, dan mendaftarkan wajah yang terdeteksi ke dalam indeks pencarian wajah Anda. Jika false, panggilan bersifat sekali jalan — tidak ada yang disimpan dan wajah tidak didaftarkan. Skrining daftar blokir dan duplikat tetap berjalan di kedua kondisi.

Contoh:

true

vendor_data
string

Pengidentifikasi buram opsional (ID pengguna, email, UUID Anda…) yang disimpan pada sesi yang dipertahankan dan dikembalikan. Juga digunakan untuk mengecualikan sesi sebelumnya dengan vendor_data yang sama dari pemeriksaan wajah duplikat, sehingga verifikasi ulang pengguna yang sama tidak memicu DUPLICATED_FACE.

Contoh:

"user-123"

metadata
object

Objek JSON opsional yang disimpan bersama sesi (saat save_api_request=true) dan dikembalikan. Dalam permintaan multipart, kirimkan sebagai kolom string berenkode JSON — kolom ini akan diuraikan menjadi sebuah objek.

Contoh:

Respons

Deteksi liveness pasif selesai. liveness.score adalah tingkat keyakinan model 0–100 bahwa gambar tersebut menampilkan orang sungguhan; status bernilai Approved kecuali jika peringatan berbobot error terpicu. Wajah hasil spoofing atau yang masuk daftar blokir tetap mengembalikan 200 — periksa liveness.status dan liveness.warnings, bukan hanya kode HTTP. Ketika save_api_request=true, request_id adalah ID sesi yang disimpan.

request_id
string<uuid>

ID sesi yang disimpan saat save_api_request=true (dapat digunakan dengan GET /v3/session/{sessionId}/decision/); jika tidak, berupa UUID korelasi sementara.

liveness
object
vendor_data
string | null

Salinan vendor_data yang Anda kirimkan, atau null.

metadata
object | null

Salinan objek metadata yang Anda kirimkan, atau null.

created_at
string<date-time>

Stempel waktu ISO 8601 (UTC) saat respons dibuat, misalnya 2026-06-12T01:04:42.763237+00:00.

Terakhir diubah pada 7 November 2026