Lewati ke konten utama
Dapatkan ProsesGET

Ambil proses yang sudah ada berdasarkan identifier-nya. Sesuai kontrak API, hasil sudah dikembalikan secara sinkron saat proses dibuat — gunakan endpoint ini untuk kueri ulang, audit, dan dukungan.

MarkdownChatGPTClaude
peringatan

Sebelum mengambil proses, tinjau konfigurasi webhook dan strategi fallback kami — klik di sini.

Endpoint​

LingkunganURL
ProductionGET https://api.id.unico.app/processes/v1/{processId}
SandboxGET https://api.id.uat.unico.app/processes/v1/{processId}

Permintaan​

Headers
HeaderNilai
AuthorizationBearer <access_token>
APIKEYAPI key yang telah disediakan.
Parameter path
ParameterTipeWajibDeskripsi
processIdstring (UUID)yaIdentifier proses yang dikembalikan oleh Create Process.

Contoh​

curl -X GET https://api.id.unico.app/processes/v1/$PROCESS_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "APIKEY: $API_KEY"

Respons​

200 OK

Kontrak ini bersifat unik — field idCloud.result membawa keputusan konsolidasi dari kapabilitas yang digunakan.

Unico mengonsolidasikan hasil dari kapabilitas yang dijalankan menjadi satu idCloud.result, siap untuk menentukan langkah berikutnya dalam alur Anda — tanpa perlu mengorkestrasi hasil individual.

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "idCloud": {
    "result": "approved"
  }
}
FieldTipeDeskripsi
idstring (UUID)Identifier proses.
statusinteger1 (memproses), 2 (perbedaan), 3 (selesai dengan sukses), 4 (dibatalkan), 5 (error).
Possible result values
idCloud.resultArtiTindakan yang direkomendasikan
approvedOrang nyata dan identitas tervalidasi.Lanjutkan alur.
deniedIdentitas tidak tervalidasi, pemeriksaan liveness gagal, atau risiko ekstrem teridentifikasi.Akhiri alur atau alihkan ke alur alternatif.
critical-riskTingkat risiko kritis teridentifikasi.Akhiri alur atau arahkan ke peninjauan manual.
high-riskTingkat risiko tinggi teridentifikasi.Arahkan ke peninjauan manual atau alur alternatif.
retryCapture atau skor tidak cukup untuk dievaluasi.Minta pengguna melakukan capture baru.
inconclusiveBukti tidak cukup untuk sebuah keputusan.Arahkan ke peninjauan manual atau alur alternatif.

Nilai yang dikembalikan bergantung pada recipe yang dikonfigurasi dalam APIKey Anda. Lihat Alur untuk nilai hasil yang dapat dikembalikan oleh setiap recipe.

BrazilKlien di Brasil dapat menerima respons per kapabilitas

Struktur respons secara keseluruhan tetap sama — hasil tunggal adalah default-nya.

Integrasi di Brasil dapat menerima hasil per kapabilitas yang terbuka. Setiap kapabilitas yang diaktifkan di APIKey menambahkan blok tersendiri ke respons — field untuk kapabilitas yang dinonaktifkan tidak disertakan.

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
  },
  "riskLevel": {
    "result": "inconclusive"
  },
  "idFace": {
    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "result": "FOUND"
  },
  "identityFraudsters": {
    "result": "inconclusive"
  },
  "government": {
    "serpro": 87
  },
  "liveness": 1,
  "idAge": {
    "result": "yes"
  },
  "cardholderVerification": {
    "result": "approved"
  }
}
FieldTipeDeskripsi
unicoId.resultstringyes, no, inconclusive — lihat Verifikasi Identitas.
riskLevel.resultstringnot_approved, critical_risk, high_risk, inconclusive — lihat Klasifikasi Risiko Penipuan.
idFace.resultstringFOUND — lihat Pengidentifikasi Wajah.
idFace.personIdstringPengidentifikasi opak stabil untuk wajah, dikembalikan bersama idFace.result = FOUND. Ketika tidak ada wajah yang dapat diidentifikasi dalam gambar, proses mengembalikan error 20532 alih-alih blok idFace.
identityFraudsters.resultstringTidak digunakan lagi. Gunakan riskLevel sebagai gantinya. Klien dengan integrasi yang sedang berjalan dapat terus menggunakannya sambil mengoordinasikan migrasi dengan tim proyek mereka.
government.serprointegerSkor kemiripan Serpro (0–100, -1, -2). Tersedia di Brasil saja. Lihat Hasil Kemiripan Serpro.
livenessinteger1 (lulus), 2 (gagal) — lihat Deteksi Kehidupan.
idAge.resultstringyes, no, inconclusive — lihat Verifikasi Usia. Tersedia di Brasil saja.
scoreintegerSkor risiko probabilistik. Muncul ketika unicoId.result = inconclusive dan orkestrasi skor risiko aktif. Nilai positif menunjukkan probabilitas lebih tinggi sebagai pemegang; nilai negatif menunjukkan risiko lebih tinggi. Tersedia di Brasil saja.
cardholderVerification.resultstringapproved, unsure — lihat Cardholder Verification. Tidak muncul selama status belum 3 (selesai). Tersedia di Brasil saja.
MexicoKlien di Meksiko dapat menerima blok RENAPO Verification

Respons mempertahankan struktur yang sama dan menambahkan blok idGov.

Integrasi di Meksiko dengan RENAPO Verification aktif menerima blok idGov tambahan berisi data yang disimpan RENAPO untuk CURP pengguna. Ini adalah jawaban terpisah dari hasil identitas.

{
  "id": "11111111-2222-3333-4444-555555555555",
  "status": 3,
  "idCloud": { "result": "approved" },
  "idGov": {
    "government_valid": true,
    "curp": "PUEA880304MDFRJN04",
    "government_name": "ANA PRUEBA EJEMPLO",
    "date_of_birth": "1988-03-04",
    "age": 38,
    "gender": "F",
    "deceased": false,
    "is_mexican": true,
    "citizenship": "MEXICO",
    "state_of_birth": "Ciudad de México",
    "state_iso": "MX-CMX",
    "issuing_entity_code": "DF",
    "municipality_registration": ""
  }
}
FieldTipeDeskripsi
idGovobjectData RENAPO untuk CURP. Tidak ada jika kapabilitas tidak diaktifkan. {} jika RENAPO tidak merespons. Hanya Meksiko. Lihat RENAPO Verification.

Kapan menggunakan endpoint ini​

Kontrak API mengembalikan hasil secara sinkron, jadi sebagian besar integrasi tidak memerlukan endpoint ini. Gunakan ketika:

  • Anda hanya menyimpan processId dan perlu mengambil hasil lengkap nanti (audit, dukungan).
  • Anda menduga respons asli hilang dalam transit (error jaringan setelah platform menyelesaikan pekerjaan).
  • Anda sedang membangun alat back-office yang meninjau proses historis.

Kode Error​

CodeMessageDeskripsi
20023O parâmetro processId não foi informado.Parameter process id tidak ada.
20002O parâmetro APIKey não foi informado.Parameter APIKEY tidak ada di header permintaan.
20001O parâmetro authtoken não foi informado.Parameter token integrasi tidak ada di header permintaan.

Alur​

Recipe adalah kombinasi kapabilitas (liveness, verifikasi identitas, sinyal risiko, dokumen...) yang dikonfigurasi dalam APIKey proyek Anda. Recipe menentukan apa yang dijalankan Unico dalam setiap proses dan bagaimana hasilnya dikonsolidasikan menjadi satu result — Anda tidak perlu mengorkestrasi apa pun di sisi Anda.

Unico memiliki katalog recipe yang sudah ditetapkan, diberi nama dan versi (misalnya byunico-idlive-idunico-oneresponse-std). Beberapa recipe eksklusif untuk Brasil, seperti yang menyertakan Skor, Serpro, atau verifikasi usia.

Kapabilitas apa saja yang dijalankan proses Anda?

Kombinasi kapabilitas — alur proyek Anda — ditentukan dalam konfigurasi APIKey Anda. Periksa recipe yang sudah ditetapkan atau hubungi kontak proyek Unico Anda untuk menyesuaikannya.

Terakhir diperbarui pada