--- title: Buat Proses description: Buat proses Human Token di Human API — kirim selfie (API Only) atau mulai Human Token Journey — dan dapatkan humanToken di data.humanToken. canonical: https://developer.unico.io/id/human-token/api-reference/post-processes locale: id generated_by: markdown-export --- - [/id/](/id/) - Referensi API - Buat Proses **Di halaman iniBuat ProsesPOSTBuat proses Human Token dari back-end Anda dan dapatkan humanToken di data.humanToken. Human Token berjalan di endpoint Human API `POST /client/v1/process`. Dengan alur API Only (`api+humantoken`, `api+liveness+humantoken`, dan `api+liveness+humantoken+revalidation`), proses dibuat dan diselesaikan dalam satu panggilan: respons sudah membawa hasilnya di `data.humanToken`. Dengan alur Human Token Journey (`humantoken` dan `humantoken+revalidation`), respons membawa `id` proses, sebuah `token`, dan `link` perjalanan, dan hasilnya tersedia setelah pengguna menyelesaikan perjalanan. Alur `+revalidation` memerlukan array `references` berisi `humanToken` yang diperoleh sebelumnya untuk revalidasi. ### Alur​ Human Token berjalan dalam dua model integrasi: **API Only** — back-end Anda mengirim selfie di `imageBase64`. **Human Token Journey** — pengguna menjalani perjalanan Unico di Web dan kembali ke `callbackUri` Anda. FlowCapabilitiesPossible resultIntegration componentsrequiredExample`api+humantoken`[Human Token](/id/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken`Liveness[Human Token](/id/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken+revalidation`Liveness[Human Token](/id/human-token/)RevalidationPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`humantoken`Liveness[Human Token](/id/human-token/)PROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example`humantoken+revalidation`Liveness[Human Token](/id/human-token/)RevalidationPROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example ### Endpoint​ LingkunganURL**Produksi**`POST https://humantoken.unico.app/client/v1/process` ### Permintaan​ Headers HeaderNilai`x-unico-accesskey``` (lihat [Autentikasi](/id/human-token/get-started/authentication))`Content-Type``application/json` Parameter body FieldTipeWajibDeskripsi`flow`stringyaAlur Human Token: `api+humantoken`, `api+liveness+humantoken`, `api+liveness+humantoken+revalidation` (API Only) atau `humantoken`, `humantoken+revalidation` (Human Token Journey). Lihat [Alur](#flows).`imageBase64`stringAPI OnlySelfie, diambil oleh front-end Anda dan dikirim secara langsung, dalam base64. PNG, JPEG, atau WebP, hingga 800 KB. Ikuti [Capture Standard](/id/human-token/additional-resources/capture-standard).`callbackUri`stringHuman Token JourneyURL tempat pengguna diarahkan setelah perjalanan berakhir.`companyBranchId`stringtidakPengenal branch. Jika disediakan, proses menggunakan konfigurasi branch yang ditentukan.`references`arrayAlur revalidasiArray objek referensi. Wajib untuk alur `+revalidation`. Setiap objek memiliki `referenceType` (`REFERENCE_TYPE_HUMAN_TOKEN`) dan `referenceContent` (nilai `humanToken` yang diperoleh sebelumnya). ### Respons​ 200 OK FieldTipeDeskripsi`id`string (UUID)Pengenal proses. Gunakan untuk mengambil proses kembali melalui [Dapatkan Proses](/id/human-token/api-reference/get-process).`state`stringStatus proses — lihat [Menafsirkan hasil](#interpreting-the-result). Hanya pada alur API Only.`token`stringToken dari proses yang dibuat, Anda dapat menggunakannya untuk membuka pengalaman Journey SDK. Hanya dalam alur Human Token Journey (`humantoken`, `humantoken+revalidation`).`link`stringURL Human Token Journey: arahkan pengguna ke URL ini. Hanya pada alur Human Token Journey (`humantoken`, `humantoken+revalidation`).`data.​humanToken.​value`stringPengenal wajah yang stabil dan buram (hingga 100 karakter). Orang yang sama selalu menghasilkan nilai yang sama. Hanya pada alur API Only (non-revalidasi).`data.​humanTokenMatch`string`"true"` jika selfie cocok dengan `humanToken` yang direferensikan, `"false"` jika tidak. Hanya pada alur `+revalidation` API Only. Menafsirkan hasil `state`MaknaYang harus dilakukan`PROCESS_STATE_FINISHED``data.humanToken.value` terisi: orang nyata, dengan Human Token.Cari `value` di catatan Anda: jika ada, itu adalah pengguna yang kembali atau kemungkinan duplikat; jika tidak, itu adalah orang baru.`PROCESS_STATE_FINISHED`Tidak ada `data.humanToken`, atau `value` kosong: tidak meyakinkan.Anggap hasilnya tidak meyakinkan. Jangan pernah menyimpan atau mencocokkan `value` yang kosong; ulangi proses atau tolak, sesuai aturan bisnis Anda.`PROCESS_STATE_FAILED`Proses identifikasi gagal.Ulangi proses atau tolak, sesuai aturan bisnis Anda.`PROCESS_STATE_CREATED`Proses dibuat.Tunggu. Ambil hasilnya nanti dengan [Dapatkan Proses](/id/human-token/api-reference/get-process).`PROCESS_STATE_CANCELED`Proses dibatalkan.Buat proses baru, jika pengguna masih perlu diverifikasi. peringatanSelalu pastikan `data.humanToken.value` tidak kosong sebelum menggunakannya. ### Kode Error​ catatanStatus HTTP yang dikembalikan saat access key di header `x-unico-accesskey` tidak ada atau tidak valid masih dikonfirmasi. Lihat [Autentikasi](/id/human-token/get-started/authentication). 400 Bad Request403 Forbidden429 Too Many Requests500 Internal Server ErrorKodePesanDeskripsi`3`invalid flowKetika alur yang ditentukan tidak ada.`3`INVALID_IMAGEKetika gambar bukan base64 yang valid, atau tampak seperti upaya injeksi.`3`IMAGE_TOO_LARGEKetika gambar melebihi ukuran maksimum 800 KB.`3`UNSUPPORTED_IMAGE_FORMATKetika format gambar bukan PNG, JPEG, atau WebP.`3`MISSING_IMAGEKetika gambar diperlukan untuk alur ini dan tidak dikirim.`3`INVALID_REQUESTKetika body permintaan bernilai null atau tidak dapat diinterpretasikan.`9`monthly process limit of reached for this tenantKetika batas penggunaan bulanan telah tercapai.`9`PROCESS_FAILEDKetika proses mencapai kegagalan terminal saat sedang dibuat.KodePesanDeskripsi`7`PERMISSION_DENIEDKetika kredensial valid tetapi tidak berhak melakukan tindakan ini.Batas rate tercapai. Ketika sistem Anda menerima error HTTP 429, Anda harus mengimplementasikan mekanisme untuk mencegah kegagalan berantai dan menghindari memperburuk pembatasan. **Praktik terbaik:** **Periode pendinginan (backoff):** Segera hentikan atau kurangi permintaan berikutnya dari sistem Anda. Jangan terus-menerus mencoba ulang permintaan yang gagal dalam loop yang ketat. **Antrean & pembatasan (Queueing & throttling):** Buffer atau antrean permintaan keluar dari sisi Anda untuk mengontrol aliran lalu lintas sebelum mengirimnya kembali. **Exponential backoff dengan jitter:** Saat mencoba ulang, tingkatkan waktu tunggu secara eksponensial antar percobaan (misalnya, 1 s, 2 s, 4 s, 8 s) dan tambahkan penundaan acak kecil ("jitter") untuk mencegah efek kawanan di mana semua permintaan yang diantrean mencoba ulang pada milidetik yang sama persis. peringatanTerus-menerus mengirim permintaan ke endpoint yang dibatasi rate tanpa menerapkan backoff dapat **memperpanjang periode pembatasan** dan sangat memengaruhi throughput operasional sistem Anda. Membatasi permintaan dengan benar dari sisi Anda memastikan integrasi yang lebih lancar dan lebih tangguh. Untuk batas default, peningkatan permintaan, dan detail tambahan, lihat [Batas Rate](/id/developers/start/rate-limits).KodePesanDeskripsi`13`Internal failure! Try again laterKetika terjadi kesalahan internal. Untuk daftar lengkap kode endpoint ini, lihat referensi [Buat Proses](/id/developers/api-reference/post-processes#error-codes) Human API. ### Selanjutnya​ Simpan nilai `humanToken` bersama catatan pengguna Anda untuk mengenali orang yang sama pada panggilan Human Token berikutnya. Untuk mengambil proses kembali, untuk audit atau dukungan, gunakan [Dapatkan Proses](/id/human-token/api-reference/get-process). Terakhir diperbarui pada 22 Okt 2026**