--- title: إنشاء عملية description: أنشئ عملية Human Token على Human API — أرسل صورة شخصية (API Only) أو ابدأ Human Token Journey — واحصل على humanToken في data.humanToken. canonical: https://developer.unico.io/ar/human-token/api-reference/post-processes locale: ar generated_by: markdown-export --- - [/ar/](/ar/) - مرجع API - إنشاء عملية **في هذه الصفحةإنشاء عمليةPOSTأنشئ عملية Human Token من الخادم الخلفي (back-end) الخاص بك واحصل على humanToken في data.humanToken. يعمل Human Token على نقطة النهاية `POST /client/v1/process` في Human API. مع تدفقات API Only (`api+humantoken` و`api+liveness+humantoken` و`api+liveness+humantoken+revalidation`)، تُنشأ العملية وتنتهي في استدعاء واحد: تحمل الاستجابة النتيجة بالفعل في `data.humanToken`. مع تدفقات Human Token Journey (`humantoken` و`humantoken+revalidation`)، تحمل الاستجابة `id` العملية و`token` و`link` الرحلة، وتتوفر النتيجة بعد أن يُكمل المستخدم الرحلة. تتطلب تدفقات `+revalidation` مصفوفة `references` تحتوي على `humanToken` تم الحصول عليه مسبقًا لإعادة التحقق. ### التدفقات​ يعمل Human Token وفق نموذجَي تكامل: **API Only** — يرسل الخادم الخلفي الخاص بك الصورة الشخصية في `imageBase64`. **Human Token Journey** — يمرّ المستخدم برحلة Unico على الويب ثم يعود إلى `callbackUri` الخاص بك. FlowCapabilitiesPossible resultIntegration componentsrequiredExample`api+humantoken`[Human Token](/ar/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken`Liveness[Human Token](/ar/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken+revalidation`Liveness[Human Token](/ar/human-token/)RevalidationPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`humantoken`Liveness[Human Token](/ar/human-token/)PROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example`humantoken+revalidation`Liveness[Human Token](/ar/human-token/)RevalidationPROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example ### نقطة النهاية​ البيئةالرابط**الإنتاج**`POST https://humantoken.unico.app/client/v1/process` ### الطلب​ Headers Headerالقيمة`x-unico-accesskey``` (راجع [المصادقة](/ar/human-token/get-started/authentication))`Content-Type``application/json` معاملات الطلب (Body) الحقلالنوعمطلوبالوصف`flow`stringنعمتدفق Human Token: ‏`api+humantoken` أو `api+liveness+humantoken` أو `api+liveness+humantoken+revalidation` (API Only) أو `humantoken` أو `humantoken+revalidation` (Human Token Journey). راجع [التدفقات](#flows).`imageBase64`stringAPI Onlyالصورة الشخصية، تلتقطها الواجهة الأمامية (front-end) الخاصة بك وتُرسَل مباشرةً بترميز base64. بصيغة PNG أو JPEG أو WebP، بحد أقصى 800 KB. اتّبع [معيار الالتقاط](/ar/human-token/additional-resources/capture-standard).`callbackUri`stringHuman Token Journeyعنوان URL الذي يُعاد توجيه المستخدم إليه بعد انتهاء الرحلة.`companyBranchId`stringلامعرّف الفرع. عند تقديمه، تستخدم العملية إعدادات الفرع المحدد.`references`arrayتدفقات إعادة التحققمصفوفة من كائنات المرجع. مطلوبة لتدفقات `+revalidation`. يحتوي كل كائن على `referenceType` (`REFERENCE_TYPE_HUMAN_TOKEN`) و`referenceContent` (قيمة `humanToken` التي تم الحصول عليها مسبقًا). ### الاستجابات​ 200 OK الحقلالنوعالوصف`id`string (UUID)معرّف العملية. استخدمه لاسترجاع العملية مجددًا عبر [الحصول على العملية](/ar/human-token/api-reference/get-process).`state`stringحالة العملية — راجع [تفسير النتيجة](#interpreting-the-result). في تدفقات API Only فقط.`token`stringرمز العملية المُنشأة، يمكنك استخدامه لفتح تجربة Journey SDK. فقط في تدفقات Human Token Journey (`humantoken`، `humantoken+revalidation`).`link`stringعنوان URL لرحلة Human Token Journey: أرسِل المستخدم إليه. في تدفقات Human Token Journey فقط (`humantoken`، `humantoken+revalidation`).`data.​humanToken.​value`stringمعرّف مستقر وغير شفاف للوجه (حتى 100 حرف). يُحلَّل الشخص ذاته دائمًا إلى القيمة نفسها. في تدفقات API Only فقط (بدون إعادة التحقق).`data.​humanTokenMatch`string`"true"` إذا تطابقت الصورة الشخصية مع `humanToken` المُشار إليه، و`"false"` في حال عدم التطابق. في تدفق `+revalidation` API Only فقط. تفسير النتيجة `state`المعنىما يجب فعله`PROCESS_STATE_FINISHED``data.humanToken.value` غير فارغة: شخص حقيقي، مع Human Token.ابحث عن `value` في سجلاتك: إن وُجدت، فهو مستخدم عائد أو تكرار محتمل؛ وإن لم توجد، فهو شخص جديد.`PROCESS_STATE_FINISHED`لا يوجد `data.humanToken`، أو `value` فارغة: غير حاسمة.تعامل معها على أنها غير حاسمة. لا تخزّن `value` فارغة ولا تطابقها أبدًا؛ أعد محاولة العملية أو ارفضها، وفقًا لقواعد عملك.`PROCESS_STATE_FAILED`فشلت عملية التعرّف.أعد محاولة العملية أو ارفضها، وفقًا لقواعد عملك.`PROCESS_STATE_CREATED`تم إنشاء العملية.انتظر. استرجع النتيجة لاحقًا عبر [الحصول على العملية](/ar/human-token/api-reference/get-process).`PROCESS_STATE_CANCELED`أُلغيت العملية.أنشئ عملية جديدة، إذا كان المستخدم لا يزال بحاجة إلى التحقق. تحذيرتحقق دائمًا من أن `data.humanToken.value` ليست فارغة قبل استخدامها. ### رموز الأخطاء​ ملاحظةلا يزال تأكيد رمز حالة HTTP الذي يُعاد عندما يكون مفتاح الوصول في الترويسة `x-unico-accesskey` مفقودًا أو غير صالح جاريًا. راجع [المصادقة](/ar/human-token/get-started/authentication). 400 Bad Request403 Forbidden429 Too Many Requests500 Internal Server Errorالرمزالرسالةالوصف`3`invalid flowعندما لا يكون التدفق المحدد موجودًا.`3`INVALID_IMAGEعندما لا تكون الصورة بترميز base64 صالح، أو تبدو كمحاولة حقن.`3`IMAGE_TOO_LARGEعندما تتجاوز الصورة الحجم الأقصى البالغ 800 KB.`3`UNSUPPORTED_IMAGE_FORMATعندما لا تكون صيغة الصورة PNG أو JPEG أو WebP.`3`MISSING_IMAGEعندما تكون الصورة مطلوبة لهذا التدفق ولم تُرسَل.`3`INVALID_REQUESTعندما يكون جسم الطلب فارغًا (null) أو يتعذّر تفسيره.`9`monthly process limit of reached for this tenantعند الوصول إلى حد الاستخدام الشهري.`9`PROCESS_FAILEDعندما تصل العملية إلى حالة فشل نهائية أثناء إنشائها.الرمزالرسالةالوصف`7`PERMISSION_DENIEDعندما تكون بيانات الاعتماد صالحة لكنها غير مخوّلة بتنفيذ هذا الإجراء.تم الوصول إلى حد المعدل. عندما يتلقى نظامك خطأ HTTP 429، يجب عليك تطبيق آليات لمنع حالات الفشل المتتالية وتجنب تفاقم القيود. **أفضل الممارسات:** **فترة التهدئة (backoff):** أوقف أو قلل الطلبات اللاحقة من نظامك فورًا. لا تعد محاولة الطلبات الفاشلة باستمرار في حلقة متكررة سريعة. **الطابور والتحكم بمعدل الإرسال (Queueing & throttling):** قم بتخزين الطلبات الصادرة مؤقتًا أو وضعها في طابور من جانبك للتحكم في تدفق حركة المرور قبل إعادة إرسالها. **التراجع الأسي مع التذبذب العشوائي (Exponential backoff with jitter):** عند إعادة المحاولة، قم بزيادة وقت الانتظار بشكل أسي بين المحاولات (مثال: 1 ثانية، 2 ثانية، 4 ثوانٍ، 8 ثوانٍ) وأضف تأخيرًا عشوائيًا صغيرًا ("jitter") لمنع تأثير القطيع حيث تعيد جميع الطلبات المنتظرة المحاولة في نفس الميلي ثانية بالضبط. تحذيرالاستمرار في إرسال الطلبات إلى نقطة نهاية محدودة المعدل دون تراجع يمكن أن **يُطيل فترة التقييد** ويؤثر بشكل كبير على معدل النقل التشغيلي لنظامك. التحكم السليم في معدل الطلبات من جانبك يضمن تكاملاً أكثر سلاسة ومرونة. للاطلاع على الحدود الافتراضية وزيادة الطلبات والتفاصيل الإضافية، راجع [حدود المعدل](/ar/developers/start/rate-limits).الرمزالرسالةالوصف`13`Internal failure! Try again laterعند حدوث خطأ داخلي. للاطلاع على القائمة الكاملة لرموز نقطة النهاية هذه، راجع مرجع [إنشاء عملية](/ar/developers/api-reference/post-processes#error-codes) في Human API. ### الخطوات التالية​ احفظ قيمة `humanToken` إلى جانب سجل المستخدم لديك للتعرف على الشخص ذاته في استدعاءات Human Token اللاحقة. لاسترجاع العملية مجددًا، لأغراض التدقيق أو الدعم، استخدم [الحصول على العملية](/ar/human-token/api-reference/get-process). آخر تحديث في 22 أكتوبر 2026**