> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sahlfinancial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# بيئة الاختبار والإنتاج

> مضيف واحد ومفتاح واحد وحقل للبيئة. ما الذي يغيّره الحقل وما الذي لا يغيّره.

يوجد مضيف API واحد هو `https://app.sahlfinancial.com/api` ونوع واحد من المفاتيح. يحدد كل استدعاء البيئة التي ينتمي إليها بالحقل `environment`: `sandbox` أو `production`. الافتراضي هو `sandbox`، فلا يمكن لاستدعاء نسي الحقل أن يمس بيانات الإنتاج.

| الموضع | كيف تعيّنه |
| - | - |
| `POST /v1/kyc/extract` | حقل النموذج `environment` |
| `POST /v1/kyc/verify`, `POST /v1/kyc/assess`, `POST /v1/kyc/eid` | حقل JSON ‏`environment` |
| `GET /v1/kyc/eid/{key}` | معامل الاستعلام `environment` |

أي قيمة أخرى تُرجع 422.

## ما يغيّره الحقل

| البند | بيئة الاختبار | الإنتاج |
| - | - | - |
| القضايا | قضية واحدة لكل مساحة عمل وبيئة و`reference`. | قضية منفصلة بالـ`reference` نفسه. لا ينتقل شيء بين البيئتين. |
| المستندات والأحكام وسجلات eID | تُحفظ في قضية بيئة الاختبار. | تُحفظ في قضية الإنتاج. |
| سياسة KYC لمساحة العمل | السياسة المحفوظة لـ (نوع العميل، `sandbox`). | السياسة المحفوظة لـ (نوع العميل، `production`). يمكن لكل بيئة أن تكون لها عتباتها وأقفالها. |
| الإعدادات المسبقة للأنظمة التنظيمية | مساحة العمل الخاضعة لنظام تنظيمي دون سياسة محفوظة تحصل على إعدادها المسبق. وبالنسبة إلى الجهات الكندية الملزمة بالإبلاغ يجعل الإعداد المسبق الفحص الكندي **معطّلًا** في بيئة الاختبار. | الإعداد المسبق نفسه مع الفحص الكندي **مفعّلًا**، لأنه خدمة مدفوعة ولا ينبغي أن تصل إليها حركة الاختبار. اطلبه في بيئة الاختبار بـ `canadian_screening: true`. |
| عروض وحدة التحكم | تعرض Cases وDocuments وسجل الاستدعاءات البيئة المحددة في الشريط العلوي لوحدة التحكم. | تتبع بيانات الإنتاج في وحدة التحكم خطتك: تتيح Free عشر (10) قضايا إنتاج شهريًا وتتطلب بريدًا إلكترونيًا مهنيًا موثّقًا؛ وتحصل الخطط المدفوعة على حصتها. |
| أحداث Webhook | تُرسل، مع `environment: "sandbox"` في الحمولة. | تُرسل، مع `environment: "production"`. |
| الملفات الخام بدون `reference` | لا تُحفظ في مساحة عملك. | لا تُحفظ في مساحة عملك. |

## ما لا يغيّره

| البند | التفصيل |
| - | - |
| القارئ | يقرأ نموذج الرؤية نفسه ملفات بيئة الاختبار والإنتاج. نتائج بيئة الاختبار قراءات حقيقية وليست بيانات مجهزة مسبقًا. |
| قوائم الفحص | قوائم العقوبات نفسها. |
| حصة القراءة | تُحتسب قراءات بيئة الاختبار والإنتاج من الإجمالي الشهري نفسه (2,000 افتراضيًا). |
| حد المعدل | 100 طلب في الدقيقة لكل عنوان IP للعميل، في البيئتين. |
| eID | يُستدعى مزوّد eID فعليًا، ويراسل العميل بالبريد الإلكتروني، في البيئتين. ولا يختار `environment` سوى القضية. |
| مفاتيح API | مفتاح واحد يعمل في البيئتين. |
| قواعد الحكم | الفحوص نفسها. لا يمكن أن تختلف إلا قيم السياسة. |

لا توجد قيم اختبار سحرية ولا مستندات اختبار مجهزة مسبقًا. تجيب بيئة الاختبار عمّا ترسله باستخدام المحرك الحقيقي. ويعني ذلك أن المستند الوهمي يجب أن يبدو مستندًا فعلًا، وأن العميل الوهمي يجب ألا يبدو نموذجًا توضيحيًا.

## إنشاء عميل وهمي يتصرف كما ينبغي

| افعل | السبب |
| - | - |
| استخدم أسماء مثل `Test Client`. | يُعلَّم حامل الاسم `John Doe` أو `Jane Doe` أو `Customer` أو `Client` أو `Sample` أو `Example` أو `Specimen` أو `Test Card` أو `Nom Prenom` تمامًا على أنه قالب. |
| استخدم رقم هوية غير `P123456AA` أو سلسلة من رقم واحد مكرر أو `123456789`. | هذه هي الأرقام التي تطبعها الجهات المُصدِرة على النماذج التوضيحية. |
| تجنب `123 Any St` ومدينة اسمها `City` أو `Anytown` أو `Ville`. | للسبب نفسه: عناوين القوالب. |
| لا تكتب SPECIMEN أو SAMPLE أو VOID على الصورة. | يبلّغ عنها القارئ ويفشل `authenticity:specimen:`، وهو فحص حرج. |
| استخدم تاريخ انتهاء مستقبليًا للهويات وتاريخًا حديثًا للفواتير وكشوف الحساب. | يكون `expiry:` و`recency:` حرجين على هذه المستندات. |
| استخدم CIN وهميًا مثل `BK123456` (حرف أو حرفان ثم من خمسة إلى سبعة أرقام) للعميل المغربي. وللعميل الكندي استخدم رقم SIN صحيح وفق Luhn لكنه وهمي بوضوح مثل `123456782`، أو لا تضع SIN. | يكون `format:cin:` تنبيهًا (warning) عندما يكون CIN المغربي مشوّهًا. ويكون `format:sin` حرجًا عندما يفشل SIN في فحص المجموع الاختباري. |

## الانتقال إلى الإنتاج

الاستدعاءات هي نفسها. الذي يتغير:

1. أرسل `environment: "production"`.
2. تأكد من وجود سياسة KYC للإنتاج إن أردت واحدة. وبدونها يُطبَّق الإعداد المسبق للنظام التنظيمي أو الافتراضي. انظر [قائمة التحقق قبل الإطلاق](/ar/go-live).
3. راجع حصة الإنتاج في خطتك. تتضمن Free عشر (10) قضايا إنتاج شهريًا وتتطلب بريدًا إلكترونيًا مهنيًا موثّقًا (وليس Gmail أو Yahoo)؛ وبيئة الاختبار غير محدودة في جميع الخطط.

مستندات العملاء الحقيقية مكانها الإنتاج فقط.

## البيانات المحفوظة في بيئة الاختبار

* مع `reference` تُخزَّن الملفات والحقول المقروءة والفحوص في قضية بيئة الاختبار الخاصة بك، حيث يراها موظفوك.
* بدون `reference` لا يُحفظ شيء في مساحة عملك. اسأل Sahl قبل إرسال أي شيء حساس.

## الحدود

حتى 5 ملفات لكل استدعاء `extract`، و30 MB لكل ملف افتراضيًا، و2,000 قراءة مستند شهريًا افتراضيًا، و100 طلب في الدقيقة لكل IP.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.