Langsung ke konten utama
POST
curl

Ikhtisar

Gunakan endpoint ini saat Anda mengimpor Pengguna dari penyedia lain dan sudah memiliki gambar wajah tepercaya untuk setiap orang. Pengguna tetap diidentifikasi dengan vendor_data Anda, tetapi endpoint lampiran profil ini menggunakan didit_internal_id agar Pengguna sasaran tidak ambigu.
Ini berbeda dari Unggah wajah ke daftar. Unggahan profil melampirkan wajah ke Pengguna sebagai bukti, untuk deteksi duplikat, dan untuk pencarian wajah. Unggahan ke daftar menambahkan wajah ke daftar blokir jenis wajah sehingga sesi pencocokan di masa mendatang dapat ditolak.

Endpoint

POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/

Alur migrasi

1

Buat atau temukan Pengguna

Panggil POST /v3/users/create/ untuk profil baru, atau GET /v3/users/{vendor_data}/ untuk profil yang sudah ada.
2

Simpan didit_internal_id

Respons Pengguna menyertakan didit_internal_id. Tetap gunakan vendor_data di database Anda; gunakan didit_internal_id hanya untuk endpoint lampiran profil.
3

Unggah wajah

Kirim gambar base64 mentah di kolom image. Backend memvalidasi dekode gambar, ukuran gambar, dan deteksi wajah sebelum menyimpannya.

Contoh

Isi permintaan

Respons

Validasi dan batasan

  • Maksimum 5 wajah yang diunggah secara manual per Pengguna.
  • Ukuran gambar maksimum setelah didekode adalah 2 MB.
  • Gambar harus berupa base64 yang valid dan dapat didekode sebagai gambar.
  • Gambar harus berisi wajah yang dapat dideteksi. Gunakan potongan wajah dari depan dengan pencahayaan yang baik jika memungkinkan.
  • Wajah yang diunggah diindeks untuk deteksi duplikat dan pencarian wajah di masa mendatang.
  • Wajah yang diunggah tidak otomatis masuk ke daftar blokir.

Menampilkan atau menghapus wajah yang diunggah

Menampilkan daftar wajah profil:
Menghapus satu wajah profil:

Izin

Gunakan kunci API untuk aplikasi yang sama. Kunci harus milik aplikasi yang diizinkan untuk mengelola profil Pengguna sasaran.

Mode kegagalan

  • 400: base64 tidak valid, gambar tidak valid, tidak ada wajah yang dapat dideteksi, gambar melebihi 2 MB, atau Pengguna sudah memiliki 5 wajah yang diunggah.
  • 401: kredensial tidak ada atau tidak valid.
  • 403: kunci API valid tetapi tidak diizinkan untuk mengelola profil Pengguna ini.
  • 404: tidak ada Pengguna dengan didit_internal_id tersebut dalam aplikasi.
  • 429: terkena batas laju; lakukan jeda berdasarkan Retry-After.

Terkait

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

organization_id
string<uuid>
wajib

UUID organisasi yang memiliki aplikasi.

application_id
string<uuid>
wajib

UUID aplikasi yang memiliki profil Pengguna.

didit_internal_id
string<uuid>
wajib

UUID Pengguna internal Didit, dikembalikan sebagai didit_internal_id oleh GET /v3/users/{vendor_data}/ dan POST /v3/users/create/.

Body

application/json
image
string<byte>
wajib

Gambar wajah mentah JPG atau PNG berenkode base64. Jangan sertakan awalan data:image/...;base64,. Ukuran maksimum setelah didekode: 2 MB.

comment
string
default:""

Catatan opsional yang dapat dilihat operator untuk wajah yang diunggah.

Respons

Wajah diunggah dan dilampirkan ke profil Pengguna.

uuid
string<uuid>
wajib

UUID rekaman wajah Pengguna yang diunggah.

image_url
string<uri> | null
wajib

URL bertanda tangan untuk gambar wajah yang diunggah.

comment
string | null
wajib

Komentar yang diberikan saat wajah diunggah.

uploaded_by
string | null
wajib

Email atau pengidentifikasi aktor pengunggah jika tersedia.

created_at
string<date-time>
wajib

Stempel waktu unggahan.

Terakhir diubah pada 7 November 2026