Sandbox
مفاتيح API الخاصة بـ sandbox للتحقق من الهوية.
يشغّل مفتاح sandbox واجهة API نفسها والصفحة المستضافة ومسار webhook نفسه كما في الإنتاج، لكن بمفتاح لا يُفوتر أبداً. إنه أسرع طريقة لمعرفة ما إذا كانت ShieldID مناسبة قبل الحديث عن الأسعار.
كيف يعمل
المسار نفسه. مفتاح مختلف. بلا فاتورة.
sandbox ليس وضع عرض مبسطاً، بل هو مسار التحقق الحقيقي نفسه، ويتحدد الفرق فقط بالمفتاح الذي ترسله.
| بادئة المفتاح | تحدد البادئة vk_sand_… أن المفتاح مفتاح sandbox لحظة المصادقة. لا يوجد حساب sandbox منفصل ولا لوحة تحكم منفصلة لإعدادها. |
|---|---|
| ختم البيئة | تحمل كل جلسة ونتيجة وwebhook يُنشأ بمفتاح sandbox القيمة environment: "sandbox"، فلا يمكن الخلط بين ما أُنشئ في sandbox وبين تحقق حقيقي في المراحل اللاحقة. |
| الفوترة | جلسات sandbox لا تُفوتر أبداً، في جميع الخطط، مهما بلغ عدد الجلسات التي تحتاج إليها لبناء تكاملك واختباره. |
| التحقق نفسه | حقيقي: مستندك أنت ووجهك أنت وعمليات الفحص نفسها. لا توجد مجموعة منفصلة من مستندات الاختبار المزيفة، فأنت تتحقق من هويتك لترى كيف يعمل المنتج. |
الحصول على مفتاح
اطلب مفتاحاً اليوم. الخدمة الذاتية قادمة.
إنشاء مفاتيح sandbox بالخدمة الذاتية في الخطط المؤهلة مخطط له لكن موعده لم يُحدد بعد. وإلى أن يصدر، يمكنك الحصول على مفتاح مباشرة عبر طلب من نموذج الاتصال.
اليوم
أخبرنا قليلاً عما تبنيه في نموذج الاتصال وسنزوّدك بمفتاح sandbox، وفي معظم الطلبات يكون ذلك في يوم العمل نفسه.
قريبًا
قريبًاإنشاء مفاتيح sandbox بالخدمة الذاتية، في الخطط المؤهلة، مخطط له لكن موعده لم يُحدد بعد، لتتمكن من إنشاء مفتاح فور تسجيلك.
جرّب بنفسك
سيناريوهات اختبار يمكنك تشغيلها على هاتفك.
لا حاجة إلى مستندات مزيفة؛ شغّل هذه السيناريوهات باستخدام هويتك لترى كيف يعمل كل مسار فعلياً.
نجاح كامل
أنشئ جلسة، وافتح الصفحة المستضافة، وصوّر هويتك، وأكمل تحدّي الحيوية. راقب كيف تعود checks.document وchecks.liveness وchecks.antispoof وchecks.face_match بالنتيجة PASS.
كاميرا مرفوضة
ارفض إذن الكاميرا عندما تطلبه الصفحة المستضافة. ستنتهي الجلسة إلى FAILED مع failure_reason يمكنك بناء رسالة خطأ حقيقية عليه.
إعادة المحاولة بعد الفشل (قريباً)
إعادة فتح verification_url لجلسة FAILED لإعادتها إلى PENDING لمحاولة ثانية غير متاحة بعد. أما اليوم فتعامل مع FAILED على أنها حالة نهائية، وأنشئ جلسة جديدة إذا أراد المتقدّم المحاولة مرة أخرى.
جلسة منتهية الصلاحية
أنشئ جلسة واترکها دون أي تفاعل. بعد انقضاء المهلة الافتراضية تنتقل إلى EXPIRED، دون بيانات person أو checks، وهي حالة مناسبة لاختبار رسائل انتهاء المهلة في واجهتك.
جلسة ملغاة
استدعِ DELETE /v1/sessions/{id} على جلسة PENDING، ثم حاول فتح verification_url. تأكد من أن تطبيقك يتعامل مع الجلسة الملغاة على أنها منتهية، لا على أنها خطأ.
اللغة الفرنسية
أنشئ جلسة مع locale: "fr" وتأكد من أن الصفحة المستضافة ومعالجتك لـ return-URL تظهران بشكل صحيح لمتقدّم ناطق بالفرنسية.
الحدود
ما لا يفعله sandbox.
إجابات واضحة، دون بنود صغيرة مخفية.
- لا يوجد في sandbox حد معدل منفصل عن الإنتاج، ولا يُقيَّد أي طلب حالياً بحدود على مستوى الخطة، فهذا التطبيق غير مفعّل بعد.
- يُفصل بين sandbox والإنتاج بالكامل عبر بادئة المفتاح، وليس عبر حسابات أو لوحات تحكم أو مجموعات مستندات منفصلة.
- جلسة sandbox هي تحقق حقيقي من مستند حقيقي. لا تستخدم هوية شخص آخر للاختبار، بل تحقق من هويتك.
أسئلة
الأسئلة الشائعة حول sandbox.
احصل على مفتاح
اطلب مفتاح sandbox.
أخبرنا بما تبنيه وسنزوّدك بمفتاح لتبدأ الاختبار.
لا تُحتسب رسوم على جلسات sandbox أبدًا.