Ikhtisar
Bagian ini mendokumentasikan kontrak API (dikenal secara internal sebagai TCA / Check.Integration), yang digunakan ketika aplikasi klien memiliki tahap pengambilan gambar dan mengirimkan gambar langsung ke platform.
Gunakan kontrak API ketika:
- Aplikasi Anda telah mengambil foto selfie atau gambar (melalui SDK native Unico atau stack milik sendiri — Capture Standard).
- Anda menginginkan hasil sinkron dalam respons pembuatan proses itu sendiri.
- Anda tidak ingin mengarahkan pengguna ke perjalanan yang di-host.
- Arsitektur Anda lebih menyukai panggilan server-to-server tradisional (permintaan → respons dengan hasilnya).
Jika Anda ingin Unico meng-host perjalanan tersebut, gunakan Web & SDK sebagai gantinya.
Buat proses verifikasi dengan mengirimkan gambar yang telah diambil secara langsung. Mengembalikan hasil secara sinkron.
Ambil proses kontrak API yang sudah ada berdasarkan pengidentifikasinya.
Periksa apakah pengguna sudah memiliki dokumen yang dapat digunakan ulang sebelum memulai alur pengambilan gambar baru.
Ambil dokumen baru atau gunakan ulang dokumen yang sebelumnya diambil yang terhubung ke proses biometrik.
Kueri data registrasi, pemeriksaan PEP/AML dan hubungan olahraga untuk CPF tertentu.
Library native untuk Android, iOS, dan Flutter untuk mengambil foto selfie di dalam aplikasi mobile Anda.
Persyaratan teknis yang harus dipenuhi oleh pengambilan gambar milik Anda sendiri ketika tidak menggunakan SDK Unico — resolusi, format, pencahayaan, dan lainnya.
Perbedaan dari Web & SDK
| Aspek | API | Web & SDK |
|---|---|---|
| Kapan proses dibuat | Setelah pengambilan gambar | Sebelum pengambilan gambar |
| Pengembalian gambar | Langsung (setelah pengambilan gambar di sisi klien) | Melalui endpoint khusus |
| Kendali perjalanan | Klien | Unico |
| Kendali pengambilan gambar | Klien (dengan atau tanpa SDK) | Unico |
| Identifikasi | subject.code | person.duiType + person.duiValue |
| Headers | Authorization + APIKEY | Hanya Authorization |
| Skema hasil | Datar (unicoId.result, liveness, dll.) | Bersarang (process.authenticationInfo.*Result) |
Langkah berikutnya
- Buat Proses — kontrak Onboarding lengkap.
- Kode kesalahan — menangani respons 4xx dan 5xx.