Langsung ke konten utama
GET
curl
Mengembalikan satu templat. Gunakan biometric_template_uuid yang dikembalikan oleh Hapus Sesi, biometric_template_id pada kecocokan Pencarian Wajah, atau id dari daftar.
Respons tidak pernah menyertakan gambar, vektor, id sesi yang dihapus, atau data identitas. Lihat ikhtisar untuk setiap kolom.

Kesalahan

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

template_uuid
string<uuid>
wajib

ID templat, seperti yang dikembalikan dalam biometric_template_uuid oleh endpoint penghapusan sesi, biometric_template_id pada kecocokan Pencarian Wajah, atau endpoint daftar.

Contoh:

"9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"

Respons

Templat.

uuid
string<uuid>

ID templat. Dibuat secara acak; tidak diturunkan dari sesi yang dihapus atau wajahnya.

vendor_user_uuid
string<uuid>

Pengguna pemilik.

vendor_data
string | null

vendor_data Pengguna saat ini, diselesaikan saat Anda membaca templat (tidak pernah disalin).

source_type
enum<string>

Cara templat dibuat: penghapusan sesi (API atau Console), jendela retensi data otomatis aplikasi, atau backfill yang dilakukan Didit atas instruksi Anda.

Opsi yang tersedia:
session_delete,
automatic_retention,
backfill
provenance_reference
string<uuid>

Referensi tidak transparan yang menghubungkan templat ke jejak auditnya. Ini bukan id sesi yang dihapus dan tidak dapat dikaitkan dengan id tersebut.

retention_policy
enum<string>

Kebijakan aplikasi pada saat retensi.

Opsi yang tersedia:
delete_with_session,
retain_until_user_deleted
retention_override
boolean | null

Nilai retain_face_embeddings yang dikirim pada penghapusan, atau null saat kebijakan diterapkan.

retained_at
string<date-time>
expires_at
string<date-time>

Waktu templat kedaluwarsa dan dihapus secara otomatis. Selalu ditetapkan.

retained_by
string | null

Prinsipal yang memberikan instruksi: id aplikasi untuk kunci API, id anggota Console untuk tindakan Console, atau pengidentifikasi service: untuk retensi otomatis. Tidak pernah berupa alamat email.

retained_by_type
enum<string>
Opsi yang tersedia:
API_KEY,
CONSOLE_USER,
SYSTEM
instruction_class
enum<string>
Opsi yang tersedia:
operational_session_delete,
privacy_erasure
instruction_source
enum<string>
Opsi yang tersedia:
api,
console,
automatic_retention,
backfill,
privacy_erasure,
explicit_template_purge,
vendor_user_delete,
expiry,
reconciliation,
migration,
system
instruction_id
string

instruction_id yang dikirim pada penghapusan, atau id yang dibuat oleh Didit.

held_out_of_use
boolean

true hanya selama penahanan hukum berlaku. Templat yang ditahan dikecualikan dari semua pencocokan.

status
enum<string>

Hanya templat active yang tidak ditahan, belum melewati expires_at, dan Penggunanya masih ada yang diikutsertakan dalam pencocokan.

Opsi yang tersedia:
pending,
active,
expired,
held_out_of_use,
purge_pending,
purge_failed,
purged
purged_at
string<date-time> | null
Terakhir diubah pada 7 November 2026