Verifikasi Identitas
identity.face.liveness
Face Liveness
POST
/api/v1/kyc/face/liveness-check
Cek indikasi wajah hidup dari satu foto selfie sebelum proses verifikasi lanjutan untuk menghindari spoofing. Untuk active liveness berbasis challenge, gunakan SDK session.
Body parameters
Kirim sebagai JSON body atau multipart payload. Field yang ditandai required wajib diisi.
| Name | Type | Required | Description |
|---|---|---|---|
image |
file | required | File foto selfie / wajah pengguna (default max 10MB, mengikuti MAX_UPLOAD_SIZE_MB). |
Headers
Headers berikut wajib disertakan pada setiap request ke endpoint ini.
| Name | Required | Description |
|---|---|---|
X-API-Key |
required | Secret Key untuk server-to-server API. |
Content-Type |
required | application/json atau multipart/form-data sesuai kebutuhan endpoint. |
Responses
Status code mengikuti pola umum OGI. Detail field response mengikuti jenis endpoint dan contoh di panel kanan.
| Code | Status | Deskripsi |
|---|---|---|
200 |
OK | Request berhasil diproses. |
400 |
Bad Request | Payload tidak valid (field hilang/format salah). |
401 |
Unauthorized | API key tidak valid atau tidak disertakan. |
429 |
Too Many Requests | Rate limit terlampaui. |
500 |
Internal Server Error | Kesalahan internal sistem. |
Siap mengevaluasi?
Hubungi tim solusi kami untuk akses evaluasi teknis dan diskusi integrasi.