--- title: إنشاء عملية description: إنشاء عملية تحقق. تُعيد عنوان URL للرحلة ورموز SDK تُسلّم المستخدم إلى تجربة الالتقاط المُستضافة من Unico. canonical: https://developer.unico.io/ar/developers/api-reference/post-processes locale: ar generated_by: markdown-export --- - [/ar/](/ar/) - مرجع API - إنشاء عملية **في هذه الصفحة# إنشاء عملية هذه هي نقطة الدخول لكل عملية تكامل مع Unico API. يستدعيها الخادم الخلفي (back-end) الخاص بك لإنشاء عملية؛ ويستخدم الواجهة الأمامية (front-end) الرموز المُعادة لعرض iFrame، أو إعادة توجيه المستخدم، أو تهيئة SDK أصلي. للتعرف على تدفق التكامل الكامل، راجع [التدفقات](/ar/developers/start/flows). ### النقطة النهائية​ البيئةالرابط**الإنتاج**`POST https://api.idcloud.unico.app/client/v1/process`**Sandbox**`POST https://api.idcloud.uat.unico.app/client/v1/process` ### الطلب​ Headers Headerالقيمة`Authorization``Bearer ` (راجع [المصادقة](/ar/developers/start/authentication))`Content-Type``application/json` معاملات الطلب (Body) متطلبات الحقول تعتمد على التدفقما إذا كان الحقل مطلوبًا أو اختياريًا أو غير قابل للتطبيق يعتمد على `flow` الذي تدمجه — راجع [التدفقات](/ar/developers/start/flows) لمعرفة الوصفة المحددة التي تستخدمها قبل افتراض متطلبات الحقل من هذا الجدول فقط. الحقلالنوعالوصف`callbackUri`stringعنوان URL الذي يُعاد توجيه المستخدم إليه بعد انتهاء الرحلة. استخدم `/` لتدفقات SDK الأصلي حيث يتم التعامل مع الاستدعاء داخل التطبيق.`flow`stringمعرّف التدفق — يحدد الإمكانيات التي تعمل. أمثلة: `idunicodocs`، `idunicosign`، `idchecktrust`، `idtoken`، `idsmart`. راجع [التدفقات المتاحة](/ar/developers/start/flows).`purpose`stringالغرض التجاري. القيم المقبولة: `creditprocess`، `biometryonboarding`، `carpurchase`، `ageverification`.`person.duiType`enumنوع الوثيقة. راجع [قيم `duiType`](#duitype-values) أدناه.`person.duiValue`stringرقم الوثيقة، بدون تنسيق.`person.friendlyName`stringاسم العرض للمستخدم الظاهر في واجهة الرحلة. الحد الأقصى 50 حرفًا.`person.phone`stringرقم الهاتف بصيغة رمز الدولة + رمز المنطقة + الرقم، بدون فواصل. مطلوب عند إرسال الإشعارات عبر SMS أو WhatsApp.`person.email`stringعنوان البريد الإلكتروني. مطلوب للتدفقات التي تتضمن التوقيع الإلكتروني.`person.​notifications`arrayقنوات الإشعارات لإرسال رابط الرحلة. يحتوي كل عنصر على `notificationChannel`: `NOTIFICATION_CHANNEL_WHATSAPP`، `NOTIFICATION_CHANNEL_SMS`، أو `NOTIFICATION_CHANNEL_EMAIL`.`references`arrayمدخلات مرجعية لتدفقات التحقق 1:1 وإعادة التحقق الذكية. يحتوي كل عنصر على `referenceType` (‏`REFERENCE_TYPE_IMAGE_BASE64` أو `REFERENCE_TYPE_PROCESS_ID`) و`referenceContent` (صورة مُرمَّزة بـ base64 أو UUID للعملية). أرسل عنصرًا واحدًا كحد أقصى — تُرفض مصفوفة أطول برمز `400`، ويجب ألا يكون `referenceContent` فارغًا.`useCase`stringسيناريو إعادة التحقق الذكية. مطلوب لـ 🇧🇷 `idsmart`، `idsmart_r2`، `idsmart_tp1`. أمثلة: `USE_CASE_LOGIN`، `USE_CASE_FIN_TRANSACTIONS`.`clientReference`stringمعرّف فريد للمستخدم في نظامك. **مطلوب لإمكانية [حسابات متعددة](/ar/capabilities/multi-accounts).** فريد في قاعدتك، بحد أقصى 256 حرفًا، بدون مسافات.`companyBranchId`string (UUID)معرّف الفرع. مطلوب فقط إذا كان حساب الخدمة مرتبطًا بأكثر من فرع واحد.`expiresIn`stringنافذة صلاحية العملية من الإنشاء. الصيغة: `"3600s"`. القيمة الافتراضية 7 أيام إذا لم تُحدَّد.`flowConfig`objectتجاوزات التهيئة الخاصة بكل تدفق.`flowConfig.​biometryCapture.​enabledBackCamera`booleanاستخدام الكاميرا الخلفية للجهاز. غير متوافق مع تدفقات التقاط الوثائق أو التوقيع الإلكتروني.`contextualization`objectسياق المعاملة المعروض للمستخدم خلال الرحلة لتوضيح الالتقاط. متاح للعملاء في أي منطقة — لا يقتصر على بلد معين.`contextualization.​company_name`stringاسم الشركة المعروض خلال الرحلة. الحد الأقصى 20 حرفًا.`contextualization.​currency`stringرمز العملة المعروض للمستخدم. القيم المقبولة: `BRL`، `MXN`، `USD`.`contextualization.​price`numberمبلغ المعاملة المعروض للمستخدم.`contextualization.​locale`objectالنص المُترجَم المعروض خلال الرحلة. المفاتيح: `ptBr`، `enUs`، `esMx` — وهذه هي اللغات الوحيدة المدعومة للنص، بغض النظر عن منطقة العميل.`contextualization.locale.{ptBr|enUs|esMx}.reason`stringسبب مختصر للالتقاط، يُعرض خلال الرحلة. الحد الأقصى 50 حرفًا.`contextualization.locale.{ptBr|enUs|esMx}.title`stringعنوان إشعار العميل المعروض خلال الرحلة. الحد الأقصى 100 حرف. يجب تقديمه مع `text`. تُحذف علامات HTML.`contextualization.locale.{ptBr|enUs|esMx}.text`stringنص إشعار العميل المعروض خلال الرحلة. الحد الأقصى 210 حرفًا. يجب تقديمه مع `title`. تُحذف علامات HTML.`imageBase64`stringالصورة الشخصية، مُرسَلة مباشرة. تقبل JWT الالتقاط الخاص بـ SDK.`document.purpose`enumالغرض من الوثيقة. مفردات ثابتة: `DOCUMENT_PURPOSE_ONBOARDING`، `DOCUMENT_PURPOSE_CREDIT_PROCESS`، `DOCUMENT_PURPOSE_CAR_PURCHASE`، `DOCUMENT_PURPOSE_PAY_BY_PAYCHECK`، `DOCUMENT_PURPOSE_FGTS`. تُستخدم فقط مع تدفقات Face Document Match.`document.​files[].​data`bytesالتقاط وثيقة جديدة، مُرمَّز بـ base64. متاح عالميًا، وليس مقتصرًا على البرازيل. متعارض مع `document.documentId`.`document.documentId`string (UUID)يعيد استخدام وثيقة تم التقاطها مسبقًا لنفس الشخص، بدلًا من التقاط جديد. متعارض مع `document.files[]`.`expectedResult`objectيحاكي نتيجة إمكانية في بيئات الاختبار/sandbox ويضع علامة `simulated: true` على الاستجابة. راجع [محاكاة النتائج (Test Mock)](/ar/developers/start/test-mock). **قيم `duiType`**الدولةالقيمةالوصفAR`DUI_TYPE_AR_PASSPORT`جواز سفر أرجنتينيAR`DUI_TYPE_AR_DNI`DNI الأرجنتينيAR`DUI_TYPE_AR_LNC`رخصة القيادة الأرجنتينية (Licencia Nacional de Conducir)AT`DUI_TYPE_AT_STNR`الرقم الضريبي النمساوي (STNR)BE`DUI_TYPE_BE_NN`الرقم الوطني البلجيكي (NN)BR`DUI_TYPE_BR_CPF`CPF البرازيليBR`DUI_TYPE_BR_PASSPORT`جواز سفر برازيليBR`DUI_TYPE_BR_CNPJ`CNPJ البرازيليCA`DUI_TYPE_CA_SIN`SIN الكنديCH`DUI_TYPE_CH_AHV`رقم AHV/AVS السويسريCL`DUI_TYPE_CL_RUN`RUN التشيليCL`DUI_TYPE_CL_PASSPORT`جواز سفر تشيليCL`DUI_TYPE_CL_LICENCIA_CONDUCIR`رخصة القيادة التشيلية (Licencia de Conducir)CO`DUI_TYPE_CO_NIT`NIT الكولومبيCO`DUI_TYPE_CO_PASSPORT`جواز سفر كولومبيCO`DUI_TYPE_CO_LICENCIA_CONDUCCION`رخصة القيادة الكولومبية (Licencia de Conducción)CO`DUI_TYPE_CO_CC`بطاقة المواطنة الكولومبية (Cédula de Ciudadanía)DE`DUI_TYPE_DE_IDNR`رقم التعريف الضريبي الألماني (IdNr)DK`DUI_TYPE_DK_CPR`CPR الدنماركيEC`DUI_TYPE_EC_NI`NI الإكوادوريES`DUI_TYPE_ES_NIE`رقم هوية الأجانب الإسباني (NIE)ES`DUI_TYPE_ES_DNI`وثيقة الهوية الوطنية الإسبانية (DNI)FI`DUI_TYPE_FI_HETU`رمز الهوية الشخصية الفنلندي (HETU)FR`DUI_TYPE_FR_SPI`الرقم الضريبي المرجعي الفرنسي (SPI)GB`DUI_TYPE_GB_NINO`رقم التأمين الوطني البريطاني (NINO)GT`DUI_TYPE_GT_CUI`CUI الغواتيماليID`DUI_TYPE_ID_NIK`NIK الإندونيسيIE`DUI_TYPE_IE_PPSN`رقم الخدمة العامة الشخصي الأيرلندي (PPSN)IT`DUI_TYPE_IT_CF`Codice Fiscale الإيطالي (CF)LK`DUI_TYPE_LK_NIC`NIC سريلانكيLU`DUI_TYPE_LU_MATRICULE`رقم الهوية الوطني اللوكسمبورغي (Matricule)MX`DUI_TYPE_MX_CURP`CURP المكسيكيMX`DUI_TYPE_MX_RFC_PERSONA_FISICA`RFC المكسيكي (شخص طبيعي)MX`DUI_TYPE_MX_LICENCIA_CONDUCIR`رخصة القيادة المكسيكية (Licencia de Conducir)NG`DUI_TYPE_NG_NIN`NIN النيجيريNG`DUI_TYPE_NG_BVN`رقم التحقق المصرفي النيجيري (BVN)NG`DUI_TYPE_NG_BVN_TOKEN`رمز BVN النيجيري (مُجزّأ)NG`DUI_TYPE_NG_NIN_TOKEN`رمز NIN النيجيري (مُجزّأ)NL`DUI_TYPE_NL_BSN`رقم خدمة المواطن الهولندي (BSN)NO`DUI_TYPE_NO_FNR`رقم الهوية الوطني النرويجي (Fødselsnummer)PE`DUI_TYPE_PE_RUC`RUC البيروفيPE`DUI_TYPE_PE_DNI`DNI البيروفيPE`DUI_TYPE_PE_PASSPORT`جواز سفر بيروفيPL`DUI_TYPE_PL_PESEL`PESEL البولنديPT`DUI_TYPE_PT_NIF`رقم التعريف الضريبي البرتغالي (NIF)SE`DUI_TYPE_SE_PNR`الرقم الشخصي السويدي (PNR)SE`DUI_TYPE_SE_SAMORDNINGSNUMMER`الرقم التنسيقي السويدي (Samordningsnummer)TR`DUI_TYPE_TR_TCKN`رقم الهوية التركي (TCKN)US`DUI_TYPE_US_SSN`SSN الأمريكيUS`DUI_TYPE_US_PASSPORT`جواز سفر أمريكيUS`DUI_TYPE_US_DRIVER_LICENSE`رخصة قيادة أمريكيةUS`DUI_TYPE_US_PASSPORT_CARD`بطاقة جواز سفر أمريكيةUS`DUI_TYPE_US_POLYCARBONATE_PASSPORT`جواز سفر أمريكي مصنوع من البولي كاربوناتUS`DUI_TYPE_US_ID_CARD`بطاقة هوية أمريكيةUY`DUI_TYPE_UY_CI`CI الأوروغويانيZZ`DUI_TYPE_ZZ_EMAIL`عنوان البريد الإلكترونيZZ`DUI_TYPE_ZZ_PHONE_NUMBER`رقم الهاتف إنشاء عملية بدون وثيقةعندما يسمح التدفق بوثيقة اختيارية، يمكنك حذف `person.duiType` و`person.duiValue`. بعد الالتقاط، تنتظر العملية في الحالة `AWAITING_FOR_DOCUMENT` حتى ترسل الواجهة الخلفية (back-end) الخاصة بك الوثيقة باستخدام [تعيين وثيقة العملية](/ar/developers/api-reference/set-process-document). ### مثال​ cURLNode.js``` curl -X POST https://api.idcloud.unico.app/client/v1/process \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "flow": "idunicodocs_r2", "purpose": "biometryonboarding", "clientReference": "pedido-88216", "callbackUri": "https://your-app.example.com/onboarding/callback", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909" } }' ``` ``` import fetch from 'node-fetch';const res = await fetch('https://api.idcloud.unico.app/client/v1/process', { method: 'POST', headers: { Authorization: `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ flow: 'idunicodocs_r2', purpose: 'biometryonboarding', clientReference: 'pedido-88216', callbackUri: 'https://your-app.example.com/onboarding/callback', person: { duiType: 'DUI_TYPE_BR_CPF', duiValue: '12345678909', }, }),});const { process: proc } = await res.json();// proc.userRedirectUrl, proc.token, proc.webAppToken ``` ### الاستجابات​ 200 OK ``` { "process": { "id": "b7c1f0a2-63d4-4f3e-9a17-2c8e5d41b0aa", "flow": "idunicodocs_r2", "state": "PROCESS_STATE_CREATED", "result": "PROCESS_RESULT_UNSPECIFIED", "purpose": "biometryonboarding", "clientReference": "pedido-88216", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909" }, "capacities": [ "PROCESS_CAPACITY_IDLIVE", "PROCESS_CAPACITY_IDUNICO", "PROCESS_CAPACITY_IDDOCS" ], "authenticationInfo": { "authenticationId": "" }, "companyData": { "branchId": "", "countryCode": "BRA" }, "callbackUri": "https://your-app.example.com/onboarding/callback", "userRedirectUrl": "https://cadastro.unico.app/flow?id=b7c1f0a2-63d4-4f3e-9a17-2c8e5d41b0aa", "token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…", "webAppToken": "eyJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiZGlyIn0…", "simulated": false }} ``` الحقلالنوعالوصف`process.id`string (UUID)معرّف العملية. استخدمه لجلب النتيجة عبر [الحصول على العملية](/ar/developers/api-reference/get-process).`process.state`enum`PROCESS_STATE_CREATED` — تم إنشاء العملية، ولم تبدأ الرحلة بعد. `PROCESS_STATE_FAILED` — فشل إنشاء العملية.`process.result`enumنتيجة التحقق. موجودة فقط عندما تكون `state = PROCESS_STATE_FINISHED` — راجع [التدفقات](/ar/developers/start/flows) لمعرفة قيم النتائج التي يمكن أن يُعيدها تدفق معيّن.`process.flow`stringمعرّف التدفق المرسَل عند الإنشاء.`process.purpose`stringالغرض التجاري المرسَل عند الإنشاء.`process.callbackUri`stringعنوان URI لإعادة الاتصال المرسَل عند الإنشاء.`process.​clientReference`stringمعرّفك الداخلي المرسَل عند الإنشاء. موجود فقط إذا قُدِّم في الطلب.`process.​companyBranchId`string (UUID)معرّف الفرع. موجود فقط إذا قُدِّم في الطلب.`process.​userRedirectUrl`stringعنوان URL لإعادة توجيه المستخدم إليه (تكاملات Web Redirect وiFrame). لا تُعدّل هذا العنوان.`process.token`stringJWT لتهيئة **Web SDK iFrame**.`process.webAppToken`stringJWT لتهيئة **SDKs الأصلية** (Android وiOS وFlutter).`process.createdAt`string (date-time)الطابع الزمني لوقت إنشاء العملية.`process.expiresAt`string (date-time)الطابع الزمني الذي بعده تنتهي صلاحية العملية ولا يمكن إكمالها.`process.capacities`arrayالإمكانيات المُهيّأة لهذه العملية.`process.​authenticationInfo`objectمعلومات المصادقة للعملية (فارغة عند الإنشاء).`process.person`objectنسخة من كائن `person` المرسَل عند الإنشاء.`process.​companyData.​branchId`string (UUID)معرّف الفرع المرتبط بالعملية.`process.​companyData.​countryCode`stringرمز الدولة المرتبط بالفرع (مثل `BR`، `MX`). ### رموز الأخطاء​ 400 Bad Request401 Unauthorized403 Forbidden404 Not Found429 Too Many Requests500 Internal Server Errorالرمزالرسالةالوصف`3`invalid flowعندما لا يكون التدفق المحدد موجودًا.`3`invalid person: friendly name exceeds 50 characters.عندما يتجاوز الاسم الودّي 50 حرفًا.`3`invalid purposeعندما يكون الغرض المقدَّم غير صالح.`3`invalid callbackUri: unable to parse callbackUri: parse "": empty url, invalid callbackUri: url:عندما يكون callbackUri المقدَّم غير صالح.`3`invalid person: email required for notification channel NOTIFICATION_CHANNEL_EMAIL, invalid email address for notification channel NOTIFICATION_CHANNEL_EMAILعندما يكون البريد الإلكتروني المقدَّم غير صالح ويكون إشعار البريد الإلكتروني مُهيَّأً.`3`invalid person: phone number required for notification channel NOTIFICATION_CHANNEL_WHATSAPP, phone number does not contain 13 chars for notification channel NOTIFICATION_CHANNEL_WHATSAPPعندما يكون رقم الهاتف المقدَّم غير صالح ويكون إشعار SMS أو WhatsApp مُهيَّأً.`3`idnsv2/GetPublicID request error: rpc error: code = InvalidArgument desc = invalid dui valueعندما يكون المعرّف المقدَّم (duiValue) غير صالح.`3`invalid expiresIn argumentعندما تكون قيمة `expiresIn` غير صالحة.`3`invalid company_name argument in process contextualization, max length is 20عندما يتجاوز `contextualization.​company_name` 20 حرفًا.`3`title and text must be provided together in process contextsعندما يُقدَّم فقط أحد `title` أو `text` في لغة معيّنة.`3`invalid title argument in process contexts, max length is 100عندما يتجاوز `title` الخاص بلغة معيّنة 100 حرف.`3`invalid text argument in process contexts, max length is 210عندما يتجاوز `text` الخاص بلغة معيّنة 210 حرفًا.`3`invalid reason argument in process contexts, max length is 50عندما يتجاوز `reason` الخاص بلغة معيّنة 50 حرفًا.`3`The references array must contain at most one element.عندما يُرسَل أكثر من عنصر واحد في `references`.`3`The references[].referenceContent field is missing.عندما يكون `referenceContent` فارغًا.`3`The references[].referenceType field must be IMAGE_BASE64 or PROCESS_ID.عندما لا يكون `referenceType` أحد القيم المدعومة.`3`A reference is required for this flow.عندما يتطلب التدفق مرجعًا ولم يُرسَل أي مرجع. أرسل `references[0]` مع `referenceType` بقيمة `PROCESS_ID` أو `IMAGE_BASE64`.`9`The referenceProcessId field is invalid.عندما لا تكون العملية المرجعية موجودة أو لا يمكن إعادة استخدامها. يذكر الحقل الذي أرسلته — `bioTokenId` إذا كان هذا هو الحقل الذي أرسلته.`3`INVALID_IMAGEعندما تكون الصورة بصيغة base64 غير صالحة، أو تبدو كمحاولة حقن.`3`INVALID_DUIعندما يكون رقم الوثيقة غير قياسي أو غير موجود.`3`IMAGE_TOO_LARGEعندما تتجاوز الصورة الحد الأقصى للحجم البالغ 800 كيلوبايت.`3`UNSUPPORTED_IMAGE_FORMATعندما لا تكون صيغة الصورة PNG أو JPEG أو WebP.`3`MISSING_IMAGEعندما تكون الصورة مطلوبة لهذا التدفق ولم تُرسَل.`3`MISSING_NAMEعندما يكون الاسم مطلوبًا لهذا التدفق ولم يُرسَل.`3`MISSING_DUIعندما يكون رقم الوثيقة مطلوبًا لهذا التدفق ولم يُرسَل.`3`MISSING_PERSONعندما يكون كائن `person` مطلوبًا لهذا التدفق ولم يُرسَل.`3`INVALID_REQUESTعندما يكون نص الطلب فارغًا (null) أو لا يمكن تفسيره.`3`TOKEN_ALREADY_USEDعندما يكون رمز الالتقاط قد استُخدم من قبل. فهو للاستخدام مرة واحدة.`3`TOKEN_EXPIREDعندما تنتهي صلاحية رمز الالتقاط. يجب استخدامه في غضون 10 دقائق.`3`INVALID_BUNDLEعندما لا يستوفي الطلب متطلبات الأمان.`3`INVALID_NAMEعندما يكون الاسم أطول من الحد الأقصى المسموح به.`3`INVALID_EMAILعندما يكون عنوان البريد الإلكتروني مشوّهًا أو طويلًا جدًا.`3`INVALID_PHONEعندما يكون رقم الهاتف أطول من 20 حرفًا.`3`INVALID_DUI_TYPEعندما لا يكون نوع الوثيقة أحد القيم المدعومة.`3`INVALID_CLIENT_REFERENCEعندما يكون `clientReference` طويلًا جدًا، أو يحتوي على مسافة أو `#`.`3`INVALID_CONSENT_TYPEعندما لا تكون `consentType` هي `NONE` أو `DIRECT` أو `INDIRECT`.`3`INVALID_USE_CASEعندما لا يكون `useCase` معروفًا، أو يكون طويلًا جدًا.`3`INVALID_DEVICE_TRUST_TOKENعندما يكون رمز device-trust غير صالح أو تم استخدامه من قبل.`3`TOO_MANY_REFERENCESعندما يُرسَل أكثر من عنصر واحد في `references`.`3`INVALID_REFERENCE_TYPEعندما لا يكون `referenceType` هو `IMAGE_BASE64` أو `PROCESS_ID`.`3`INVALID_REFERENCE_PROCESSعندما لا يكون معرّف العملية المرجعية معرّفًا صالحًا.`3`REFERENCE_PROCESS_NOT_FOUNDعندما لا تكون العملية المُشار إليها موجودة.`3`REFERENCE_PROCESS_NOT_READYعندما لا تحتوي العملية المُشار إليها على نتيجة قابلة لإعادة الاستخدام، أو تم استخدامها من قبل.`3`REFERENCE_SELFIE_NOT_FOUNDعندما لا تحمل العملية المُشار إليها صورة شخصية لإعادة استخدامها.`3`INVALID_CAPTURE_TOKENعندما لا تكون الصورة المُلتقَطة رمزًا صالحًا نتج عن SDK التقاط.`3`INVALID_CAPTURE_SIGNATUREعندما لا يتحقق توقيع رمز الالتقاط.`3`PRIOR_CAPTURE_NOT_FOUNDعندما لا يمكن تحديد الالتقاط السابق الذي يبني عليه هذا الطلب. أعد بدء العملية.`3`PRIOR_CAPTURE_IN_PROGRESSعندما لا يكون الالتقاط السابق قد انتهى بعد. أعد المحاولة بعد قليل.`3`PRIOR_CAPTURE_FAILEDعندما لا يمكن إكمال الالتقاط السابق. أعد بدء العملية.`3`INVALID_DOCUMENTعندما يكون ملف الوثيقة غير قابل للقراءة، أو محميًا بكلمة مرور، أو بصيغة غير مدعومة.`3`INVALID_AUTH_PROCESSعندما يكون `document.authProcessId` غير صالح، أو منتهي الصلاحية، أو يخص شخصًا آخر.`3`INVALID_DOCUMENT_PURPOSEعندما لا يكون `document.purpose` أحد القيم المدعومة.`3`PROCESS_REUSE_NOT_ENABLEDعندما لا يسمح التدفق بإعادة استخدام عملية سابقة بدون صورة. أرسل صورة بدلًا من ذلك.`9`PROCESS_FAILEDعندما تصل العملية إلى فشل نهائي خلال الإنشاء.`9`Tenant API key is not configuredعندما لا يكون مفتاح API مُهيَّأً بشكل صحيح.رمز Bearer مفقود، منتهي الصلاحية، أو غير صالح. راجع [المصادقة](/ar/developers/start/authentication).الرسالةالوصفJwt header is an invalid JSONعندما يحتوي رمز الوصول المستخدَم على أحرف غير صحيحة.Jwt is expiredعندما تنتهي صلاحية رمز الوصول المستخدَم.الرمزالرسالةالوصف`7`INVALID_API_KEYعندما يكون مفتاح API غير صالح أو مفقودًا.`7`INVALID_AUTH_TOKENعندما يكون رمز المصادقة غير صالح.`7`PERMISSION_DENIEDعندما تكون بيانات الاعتماد صالحة ولكن غير مخوَّلة لهذا الإجراء.`7`TOKEN_TENANT_MISMATCHعندما يكون رمز الالتقاط قد صدر لمستأجر مختلف.`7`MISSING_ACCESS_TOKENعندما يكون رأس التفويض (authorization header) مفقودًا.الرمزالرسالةالوصف`5`NO_RESULTS_FOUNDعندما لا يمكن العثور على وثيقة أشار إليها الطلب.تم الوصول إلى حد المعدل. عندما يتلقى نظامك خطأ 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/get-process) لجلب النتيجة، أو انتظر [webhook](/ar/developers/webhooks-and-events). لعرض جميع تركيبات الوصفات وقيم نتائجها الممكنة، راجع [التدفقات](/ar/developers/start/flows). لاختبار نتيجة بدون التقاط بيومتري حقيقي، راجع [محاكاة النتائج (Test Mock)](/ar/developers/start/test-mock). آخر تحديث في 8 أكتوبر 2026**