---
title: Ikhtisar
description: Kontrak API — digunakan ketika klien mengendalikan pengambilan gambar dan mengirimkan gambar langsung dalam permintaan.
canonical: https://developer.unico.io/id/dual-api/developers/api-reference/api/
locale: id
generated_by: markdown-export
---

Bagian ini mendokumentasikan kontrak **API**, yang digunakan ketika aplikasi klien memiliki tahap pengambilan gambar dan mengirimkan gambar langsung ke platform.

## Kapan menggunakan kontrak ini

Gunakan kontrak API ketika:

- Aplikasi Anda **telah mengambil** foto selfie atau gambar (melalui SDK native Unico atau stack milik sendiri — [Capture Standard](/developers/sdks-and-tools/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](../web-sdk) sebagai gantinya.

## Referensi API

  **Buat Proses**

Buat proses verifikasi dengan mengirimkan gambar yang telah diambil secara langsung. Mengembalikan hasil secara sinkron.

  **Dapatkan Proses**

Ambil proses kontrak API yang sudah ada berdasarkan pengidentifikasinya.

  **Dapatkan Dokumen yang Dapat Digunakan Ulang**

Periksa apakah pengguna sudah memiliki dokumen yang dapat digunakan ulang sebelum memulai alur pengambilan gambar baru.

  **Buat Proses Dokumen**

Ambil dokumen baru atau gunakan ulang dokumen yang sebelumnya diambil yang terhubung ke proses biometrik.

  **Verifikasi Data**

Kueri data registrasi, pemeriksaan PEP/AML dan hubungan olahraga untuk CPF tertentu.

## Integrasi Klien

  **SDK Native**

Library native untuk Android, iOS, dan Flutter untuk mengambil foto selfie di dalam aplikasi mobile Anda.

  **Capture Standard**

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](./post-processes) — kontrak Onboarding lengkap.
- [Kode kesalahan](../error-codes) — menangani respons 4xx dan 5xx.