---
title: Ikhtisar
description: Referensi untuk API IDCloud — dua kontrak publik (Web & SDK dan API).
canonical: https://developer.unico.io/id/dual-api/developers/api-reference/
locale: id
generated_by: markdown-export
---

- [/id/](/id/)
- Referensi API

**Di halaman ini# Ikhtisar

### Memilih kontrak​

Pilihan kontrak adalah konsekuensi dari **di mana pengambilan biometrik terjadi** — bukan keputusan yang independen. Gunakan tabel di bawah sebagai panduan.
KontrakGunakan saat…PengambilanAlur**[Web & SDK](/id/dual-api/developers/api-reference/web-sdk)**Perjalanan pengambilan dihosting oleh Unico (Web iFrame, Redirect, atau SDK native)Unico yang mengendalikanProses dibuat **sebelum** pengambilan → pengguna menjalani perjalanan → hasil dikembalikan melalui callback atau polling**[API](/id/dual-api/developers/api-reference/api)**Aplikasi Anda mengendalikan pengambilan (dengan atau tanpa Unico SDK) dan mengirimkan gambar langsung dalam panggilanKlien yang mengendalikanGambar dikirim **bersamaan** dengan pembuatan proses → hasil dikembalikan secara sinkron
### Host dan environment​

KontrakHost SandboxHost ProductionWeb & SDK`https://api.idcloud.uat.unico.app``https://api.idcloud.unico.app`API`https://api.id.uat.unico.app``https://api.id.unico.app`OAuth2 / Token`https://identityhomolog.acesso.io``https://identity.acesso.io`
Detail lengkap di [Environments](/id/dual-api/developers/api-reference/environments).
### Autentikasi​

Semua kontrak Unico menggunakan **Bearer token (JWT)** yang diperoleh melalui OAuth2 dengan `urn:ietf:params:oauth:grant-type:jwt-bearer`.
Detail lengkap di [Authentication](/id/dual-api/developers/api-reference/authentication).
### Perbedaan payload antar kontrak​

Operasi konseptual yang sama ("membuat proses verifikasi identitas") terlihat berbeda di setiap kontrak. Gunakan tabel di bawah sebagai referensi cepat saat bermigrasi antar integrasi.
Pembuatan proses
AspekWeb & SDKAPI**Endpoint**`POST /client/v1/process``POST /processes/v1`**Auth**`Authorization: Bearer <jwt>``Authorization: Bearer <jwt>` + `APIKEY`**Gambar**Tidak dikirim (diambil oleh perjalanan Unico)Dikirim sebagai `imageBase64`**Identifikasi pengguna**`person.duiType` + `person.duiValue``subject.code` (CPF / CURP)**Jenis dokumen**CPF, CURP, SSN, NIN, DNI, NIKHanya CPF, CURP**Definisi pipeline**`flow` (enum, 30+ nilai)Implisit dalam `APIKEY` (kemampuan)**Callback**`callbackUri` (redirect pengguna)Tidak ada (sinkron)**Webhook**Webhook v1 (hasil akhir)Webhook v1 (opsional)**Mengembalikan URL perjalanan**Ya (`userRedirectUrl`)Tidak**Hasil**Asinkron (polling GET atau webhook)Sinkron (dalam respons)**SDK token**Ya (`token`, `webAppToken`)Tidak
Pengambilan hasil
AspekWeb & SDKAPI**Endpoint**`GET /client/v1/process/\{id\}``GET /processes/v1/\{id\}` (juga dalam respons pembuatan)**Status**`state` + `result` (enum dengan awalan)`status` (1, 3, 5)**Struktur hasil**Bersarang di bawah `process.authenticationInfo.{capability}Result`. Di Meksiko, `idGov` di bawah `authenticationInfo`.Datar: `unicoId`, `liveness`, `government`, `identityFraudsters`, `idGov` (hanya Meksiko)**Dokumen**`services[].documents[]` (RG/CNH dengan OCR)Endpoint terpisah (`GET /processes/v1/\{id\}/document`)
### Langkah berikutnya​

[Authentication](/id/dual-api/developers/api-reference/authentication) — alur OAuth2 dan pembuatan JWT
[Environments](/id/dual-api/developers/api-reference/environments) — sandbox vs production
[Postman Collection](/id/dual-api/developers/api-reference/postman) — koleksi siap pakai
[Webhooks and Events](/id/developers/webhooks-and-events) — pengiriman hasil asinkron
[SDKs and Tools](/id/developers/sdks-and-tools/overview) — Web SDK, Android, iOS, Flutter
Terakhir diperbarui pada 8 Okt 2026**