كيف تختار واجهة API لكشف الذكاء الاصطناعي: عشرة معايير قبل الربط

لاختيار واجهة برمجة التطبيقات (API) لكشف الذكاء الاصطناعي، تحقق من عشرة معايير تحدد ما إذا كانت الواجهة ستصمد في بيئة الإنتاج: ما الذي تفحصه وما الذي تعيده، وحدود المُدخلات، وطريقة تسليم النتائج، وهل توقيع Webhook موثّق، وهل إعادة المحاولة آمنة، وكيف تتعامل الواجهة مع الأخطاء وحدود معدل الطلبات، وما الذي تحتفظ به الخدمة ولكم من الوقت، وهل يمكن تدقيق النتيجة وربطها بإصدار محدد للنموذج، وكم يكلّف الطلب الفاشل وطلب الاختبار. يمكن الإجابة عن معظم هذه المعايير من وثائق المزوّد قبل كتابة أي شيفرة، أما الباقي فيحتاج إلى مشروع تجريبي (Pilot) قصير.

يخاطب هذا الدليل المطورين والمشترين التقنيين في شركات التأمين والبنوك وشركات التمويل ومنصات التجارة الإلكترونية، ممن يربطون خدمة كشف بمسارات استلام المطالبات أو التحقق من مستندات العملاء عند فتح الحساب أو مراجعة فواتير الموردين أو الإشراف على المحتوى. وهو يقيّم الواجهة لا الكاشف. أما دقة كشف الصور المولَّدة بالذكاء الاصطناعي والإيجابيات الكاذبة وعبء المراجعة فتجدها في دليل اختيار برنامج كشف الصور المولَّدة بالذكاء الاصطناعي ودليل دقة كاشف الصور بالذكاء الاصطناعي. فقد يتفوق كاشف على ملفاتك ثم يخفق في الإنتاج إذا كانت الواجهة المحيطة به يصعب معها إعادة المحاولة أو التدقيق أو ضبط التكلفة.

يشرح كل معيار أدناه سبب أهميته، وكيف تتحقق منه في وثائق أي مزوّد، وما الذي توثقه واجهة Fileverity بشأنه، مع روابط إلى وثائق API. وتنطبق الأسئلة العشرة نفسها على كل مزوّد مرشح، ولا يسمّي هذا الدليل أي مزوّد ولا يرتّبه. وللقارئ العربي بند إضافي في التقييم هو اللغات التي تدعمها الواجهة، ويعالجه المعيار الأول.

المعايير العشرة في لمحة

يبيّن الشكل أدناه أين يمكن الإجابة عن كل معيار. فالتوثيق يخبرك بما يعد به المزوّد، ومفتاح الاختبار يُظهر شكل الطلبات والاستجابات، أما المشروع التجريبي على ملفاتك أنت وحده فيكشف الزمن والحذف والفوترة.

النطاق والمُدخلات

نوع الفحص والمخرجات

أهمية المعيار. عبارة «كشف الذكاء الاصطناعي» تشمل مهام مختلفة: هل الصورة مولَّدة أم معدَّلة؟ وهل المستند معدَّل أم يتضمن مقاطع مكتوبة بالذكاء الاصطناعي؟ وهل النص العادي مكتوب بالذكاء الاصطناعي؟ والمزوّد الذي يدعم إحدى هذه المهام قد لا يدعم غيرها. والاستجابة التي ليست سوى رقم، بلا نطاق ولا أدلة، يصعب اتخاذ إجراء بناءً عليها ويصعب الدفاع عنها. يحتاج المراجِعون إلى معرفة ما تنطبق عليه النتيجة، ويحتاج منطق التوجيه لديك إلى حقل ثابت تقرؤه الآلة.

كيف تتحقق. اكتب قائمة بالمهام التي تحتاج إليها وابحث عن كل منها في الوثائق باسمها. افتح مخطط الاستجابة وابحث عن أربعة عناصر: ملخص تقرؤه الآلة (حكم أو مستوى أو إجراء موصى به) منفصل عن النتائج التفصيلية؛ وأدلة يستطيع الإنسان قراءتها؛ وحالة «تعذّر التقييم» تختلف عن «سلبي»؛ وإصدار للمخطط. واطلب أمثلة على الاستجابات تشمل حالة مُعلَّمة ونتيجة سليمة ونتيجة غير حاسمة وحالة فشل. وتبيّن مصفوفة التغطية في دليل الشراء كيف تسجّل الإجابات. واسأل كذلك عن اللغات: ما لغات النص التي يدعمها كاشف النص، وبأي لغة تُكتب نتائج المستندات والتقارير. ولا تفترض أن ما يعمل بالإنجليزية يعمل بالعربية، وأدرج في اختبارك مستندات عربية وأخرى ثنائية اللغة (عربي وإنجليزي).

ما لا يغنيك عنه الفحص. يفحص كاشف الملفات الملف نفسه، ولا يتحقق من الواقعة التي يدّعيها. فإذا لم تُرصد علامات تعديل في فاتورة PDF، تبقى حاجتك قائمة إلى التحقق لدى الجهة المُصدِرة. ومن أمثلة ذلك في المملكة العربية السعودية خدمة «التحقق من صحة الفاتورة الإلكترونية» (E-Invoice Validation) التي تتيحها هيئة الزكاة والضريبة والجمارك (زاتكا)، ويمكن من خلالها التحقق من صحة الفاتورة الإلكترونية بمسح رمز الاستجابة السريعة (QR Code) الموجود عليها (صفحة الخدمة على موقع الهيئة). فهذان فحصان مختلفان يكمل أحدهما الآخر، ولا تغني نتيجة أحدهما عن الآخر. وللمزيد عن مراجعة الفاتورة قبل سدادها انظر دليل التحقق من الفاتورة قبل الدفع.

ما الذي توثقه Fileverity. ثلاثة نماذج، يُعرض كل منها مع حدوده وإصداره المؤرَّخ (Snapshot) عبر GET /models: النموذج fvimg-2 (FVIMG V2) للصور، والنموذج fvdoc-3 (FVDOC V3) للمستندات، والنموذج fvdoc-3-text (FVDOC V3 Text) للنص العادي. تعيد فحوص الصور والمستندات تقريرًا كاملًا يتضمن مستوى إجماليًا وإجراءً موصى به والنتائج التفصيلية ورقم التقرير وتقرير PDF مختومًا. وتعيد فحوص النص نتيجة تتضمن حكمًا (نص مكتوب بالذكاء الاصطناعي أو مختلط أو كتبه إنسان) ودرجات وفقرات معلَّمة. وتذكر وثائق النص أن النتيجة تقدير إحصائي وليست إثباتًا للتأليف، وأنها لا ينبغي أن تحسم وحدها أمرًا يمس شخصًا. أما اللغات فيقبل كشف النص الإنجليزية والفرنسية والألمانية والإسبانية والصينية، ولا يدعم العربية، ويعيد الخطأ unsupported_language ردًّا على الطلب الذي لغته غير مدعومة أو تعذّر اكتشافها. وتُكتب نتائج المستندات بلغة تحددها بالخيار options.locale والإنجليزية هي الافتراضية، فراجع قائمة اللغات المتاحة في الوثائق وقت التكامل. انظر في الوثائق: نظرة عامة، كائن التقرير، كشف النصوص. وانظر كذلك صفحتي واجهة كشف الصور المولَّدة بالذكاء الاصطناعي وواجهة كشف تزوير المستندات.

حدود المُدخلات

أهمية المعيار. تحدد الحدود ما إذا كانت قناة الاستلام لديك ستناسب الخدمة: صور الهواتف، ولقطات الشاشة، والمسح الضوئي، وملفات PDF متعددة الصفحات، والملفات المحمية بكلمة مرور، والنصوص الطويلة. والحد الذي تصطدم به أول مرة في الإنتاج يتحول إلى طلبات فاشلة ومستخدمين منزعجين.

كيف تتحقق. ابحث عن الحدود الخاصة بكل نوع: الصيغ المقبولة، والحجم الأقصى، والأبعاد بالبكسل أو عدد الصفحات، وطول النص ولغاته. وتحقق من طريقة رفع الملفات الكبيرة (طلب واحد أو رفع برابط مسبق التوقيع)، وهل تُكتشف الصيغة من محتوى الملف أم يُعتمد على اسمه، وماذا تعيد كل مخالفة. رمز خطأ مميز لكل حالة علامة جيدة؛ أما اقتطاع المحتوى بصمت أو الخطأ 400 العام فليسا كذلك. ثم أرسل أكبر الملفات وأصغرها وأكثرها غرابة مما يصلك فعلًا. وإن كانت ملفاتك تصل عبر تطبيقات المراسلة أو بصورة لقطات شاشة فأدرجها في الاختبار، فقد لا تكون الصورة المنقولة ملف المرسل الأصلي، وهو ما يشرحه دليل كشف الذكاء الاصطناعي في لقطات الشاشة والصور المضغوطة. وأضف مستندات PDF عربية وثنائية اللغة، ونماذج ممسوحة ضوئيًا تُكتب من اليمين إلى اليسار.

ما الذي توثقه Fileverity. توثّق صفحة الملفات الصيغ المدعومة والحدود لكل نموذج، والرفع المباشر متعدد الأجزاء (multipart) والرفع برابط مسبق التوقيع للملفات الأكبر، واكتشاف الصيغة من محتوى الملف، ورمز خطأ لكل حد. وللمستندات المشفرة خيار لتمرير كلمة المرور (التحليلات). ويرد طول النص ولغاته في كشف النصوص.

النتائج وطريقة تسليمها

انتظار النتائج

أهمية المعيار. قد يستغرق استدعاء ينتهي في ثوانٍ داخل بيئة التجربة وقتًا أطول تحت الحمل، ولمنصتك مهل خاصة بها: الدوال بلا خوادم، وبوابات API، والطلبات التي ينتظر المستخدم ردها. ويتبع المزوّدون إحدى طريقتين. فالاستدعاء المتزامن يعيد النتيجة في الاستجابة نفسها، والاستدعاء غير المتزامن يعود فورًا بحالة، وتحصل على النتيجة لاحقًا. وإذا كُتب التكامل على افتراض الاستدعاء المتزامن ثم واجه استدعاءً غير متزامن، فقد يفقد النتائج أو يعطّل المستخدمين. ويبيّن الشكل التالي الطرق الثلاث التي تصل بها النتيجة غير المتزامنة إلى شيفرتك.

كيف تتحقق. ابحث عن دورة حياة الحالات (قيد المعالجة، ناجح، فاشل، ملغى)، وإن كان المزوّد يستطيع إبقاء الطلب مفتوحًا فابحث عن الحد الأقصى الموثق للانتظار. وتحقق من طريقة الاستعلام الدوري (Polling) ووتيرته، وماذا يحدث حين تبلغ الطاقة الاستيعابية حدّها، وهل يُبلَّغ بموضع الطلب المنتظر في الطابور، وهل يمكن إلغاء العمل دون رسوم. ويخبر الخطأ 503 المصحوب برأس Retry-After (المعرَّف في RFC 9110 (بالإنجليزية)) شيفرتك بما تفعله. وفي المشروع التجريبي قِس الزمن الكامل عند حجم الطلبات المتوقع لأبطأ أنواع ملفاتك. أما وضع اختبار يجيب فورًا فلا يخبرك بشيء عن ذلك.

ما الذي توثقه Fileverity. فحص النص متزامن: النتيجة في الاستجابة. أما فحوص الصور والمستندات فغير متزامنة: يعيد طلب إنشاء الفحص الرمز 202 مع status: processing. ويمكنك إبقاء الطلب مفتوحًا برأس Prefer: wait، أو الاستعلام الدوري عبر GET /analyses/{id}، أو الاشتراك في Webhook، وينبغي أن تعالج 202 حتى لو انتظرت، لأن المستندات قد تدخل الطابور. وحين تكون الخدمة مشغولة يعيد طلب الإنشاء 503 service_unavailable مع retry-after ولا يُحتسب. ويمكن إلغاء فحص مستند ما زال قيد المعالجة دون رسوم. انظر: الانتظار أو الاستعلام المتكرر أو استخدام Webhooks، عندما تكون السعة المتاحة مستخدمة بالكامل.

توقيع Webhook

أهمية المعيار. نقطة نهاية Webhook عنوان عام يقبل طلبات تغيّر بيانات حالات المراجعة لديك. ومن دون تحقق يستطيع أي شخص يعثر عليها إرسال نتيجة «سليمة» مزيّفة. والتسليم بطبيعته غير مضمون: قد يُعاد تشغيل خادمك، فيجب أن يعيد المُرسِل المحاولة، وهذا يولّد أحداثًا مكررة وغير مرتبة.

كيف تتحقق. ابحث عن آلية توقيع موثقة: مفتاح سري لكل نقطة نهاية، وتوقيع على جسم الطلب الخام، وطابع زمني لرفض الطلبات القديمة. وتعرّف مواصفات Standard Webhooks (بالإنجليزية) نمطًا مفتوحًا برؤوس webhook-id وwebhook-timestamp وwebhook-signature وتوقيع HMAC-SHA256، فتستطيع المكتبات الجاهزة التحقق منه. وابحث كذلك عن طريقة تجديد المفاتيح السرية، وجدول إعادة المحاولة ومتى تتوقف، ومعرّف ثابت للحدث لإزالة التكرار، وهل تحمل الحمولة النتيجة أم المعرّف فقط، وكيف تُبلَّغ بالإخفاقات (سجل التسليم وإعادة الإرسال وتعطيل نقاط النهاية)، وحدث تجريبي يمكنك إطلاقه. وفي المشروع التجريبي اجعل نقطة النهاية تعيد خطأً مرة واحدة، ثم أرسل جسم طلب معدَّلًا وطابعًا زمنيًا قديمًا. وإن كانت شبكة مؤسستك تحجب الطلبات الواردة من الإنترنت فاسأل مبكرًا كيف تصلك الأحداث، واجعل الاستعلام الدوري بديلًا جاهزًا.

ما الذي توثقه Fileverity. تتبع Webhooks مواصفات Standard Webhooks، بالرؤوس الثلاثة وتوقيع HMAC-SHA256 على معرّف الحدث والطابع الزمني وجسم الطلب الخام. ويظهر المفتاح السري للتوقيع مرة واحدة ويمكن تجديده، وتتضمن الوثائق شيفرة تحقق بلغة JavaScript وبلغة Python. والتسليم مرة واحدة على الأقل دون ضمان للترتيب، فأزل التكرار اعتمادًا على webhook-id. وتعاد محاولة التسليم الفاشل بفواصل زمنية متزايدة لعدة أيام، وتُعطَّل نقطة النهاية التي تستمر في الفشل ويُرسل بريد إلى مالكي مساحة العمل، وتعرض لوحة التحكم آخر عمليات التسليم ويمكنها إعادة إرسال أحدها. ويرسل الزر أرسل اختبارًا حدثًا تجريبيًا موقَّعًا. ولا يحمل الحدث النتيجة: اجلبها عبر GET /analyses/{id}. وفحوص النص متزامنة ولا ترسل Webhooks، ولا ترسل مفاتيح الاختبار أحداثًا. انظر: التحقق من التوقيع، التسليم وإعادة المحاولة.

الموثوقية عند إعادة المحاولة والضغط

عدم التكرار وإعادة المحاولة

أهمية المعيار. قد تنقطع الشبكة بين إرسال طلبك ووصول الاستجابة. وإذا كانت إعادة المحاولة قادرة على إنشاء فحص ثانٍ فستدفع مرتين وقد تفتح حالة مكررة. وإذا لم تعد المحاولة قط فسيضيع منك عمل. ويتيح مفتاح عدم التكرار (Idempotency Key) للمزوّد أن يتعرف على إعادة المحاولة ويعيد النتيجة الأولى.

كيف تتحقق. ابحث عن رأس مفتاح عدم التكرار في كل نقطة نهاية تنشئ موردًا أو تترتب عليها تكلفة. وتحقق مما يحدث عند إعادة المفتاح نفسه (الاستجابة نفسها مع إشارة إلى أنها إعادة)، وعند استخدامه مع جسم طلب مختلف (ينبغي أن يُرفض لا أن يُقبل بصمت)، وأثناء تشغيل الطلب الأول، وبعد وقوع خطأ، وتحقق كذلك من مدة حفظ المفاتيح ونطاقها. والرأس موصوف في مسودة IETF Internet-Draft (بالإنجليزية) وما زالت مسودة في نوفمبر 2026، فيختلف المزوّدون في التفاصيل، ولذلك يجب اختبار السلوك. وفي المشروع التجريبي أرسل الطلب نفسه مرتين واقطع الاتصال في منتصف الطلب، ثم تأكد من وجود نتيجة واحدة واحتساب رسوم مرة واحدة فقط.

ما الذي توثقه Fileverity. يعمل الرأس Idempotency-Key على كل نقطة نهاية POST: فحوص النص ورفع الملفات وإنشاء الفحوص وإلغاؤها. وعند إعادة إرسال الطلب تُعاد الاستجابة المحفوظة مع idempotent-replayed: true دون تنفيذ أي عمل ودون احتسابه مرة أخرى. وإذا أُعيد استخدام المفتاح نفسه مع جسم طلب مختلف فالاستجابة 409 idempotency_mismatch، وإذا استُخدم أثناء تشغيل الطلب الأول فالاستجابة 409 idempotency_in_progress. ولا تُحفظ استجابات الأخطاء، فتؤدي إعادة المحاولة بعد الخطأ إلى تشغيل الطلب من جديد. ويقتصر نطاق المفاتيح على مساحة العمل والوضع (حقيقي أو اختبار) ونقطة النهاية، وتُحفظ للمدة الموثقة. انظر: Idempotency.

الأخطاء ومعرّفات الطلبات

أهمية المعيار. على شيفرتك أن تقرر ما تعيد محاولته وما تصلحه وما تعرضه للمستخدم وما تحيله إلى الدعم الفني لدى المزوّد. ورسائل الأخطاء المكتوبة بلغة مقروءة للبشر تتغير بمرور الوقت، فتتعطل الشيفرة التي تعتمد على تحليل نصها. ويتيح معرّف الطلب للطرفين العثور على الطلب نفسه لاحقًا.

كيف تتحقق. ابحث عن أخطاء بصيغة JSON موحدة، مع رمز ثابت تقرؤه الآلة منفصل عن الرسالة المقروءة للبشر، وجدول بجميع الرموز مع رمز حالة HTTP وهل تُعاد المحاولة، ومعرّف طلب في رأس كل استجابة، بما فيها الناجحة. وتأكد من أن الوثائق تبيّن هل يُحتسب الفحص الفاشل. وفي المشروع التجريبي تعمّد إحداث كل فئة من فئات الإخفاق (مفتاح غير صالح، ملف كبير جدًا، صيغة غير مدعومة، معرّف غير موجود، رصيد فارغ) وتأكد من قدرتك على التمييز بينها من الرمز وحده.

ما الذي توثقه Fileverity. تحمل الأخطاء type وcode وmessage وparam وrequest_id، وتنص الوثائق على أن يعتمد منطق شيفرتك على code لا على الرسالة. وفي كل استجابة رأس x-request-id، ويولَّد جدول رموز الأخطاء من تعريفات الواجهة نفسها. وتبيّن الوثائق ما يُعاد محاولته وما يجب إصلاحه أولًا، والفحص الذي ينتهي بخطأ لا يُحتسب. اذكر معرّف الطلب حين تكتب إلى hello@fileverity.com أو تستخدم صفحة الاتصال. انظر: الأخطاء.

حدود معدل الطلبات

أهمية المعيار. قد يتجاوز ارتفاع مفاجئ في الطلبات الحدود، كاستيراد ملفات متراكمة، أو دفعة الإغلاق الشهري، أو موسم تخفيضات كبير ترتفع فيه المرتجعات. وإذا تُركت دون إدارة تحولت إلى إخفاقات وإعادات محاولة تزيد الأمر سوءًا. وتخبرك الحدود أيضًا بطريقة الاستخدام التي يتوقعها المزوّد: وزّع العمل، وفضّل Webhooks على الاستعلام الدوري المتكرر بوتيرة عالية.

كيف تتحقق. ابحث عن الحد لكل مفتاح أو حساب ونافذته الزمنية، ورؤوس الاستجابة التي تبيّن الحد وما بقي ووقت إعادة الضبط، واستجابة 429 مع رأس Retry-After (يعرّف RFC 6585 (بالإنجليزية) رمز الحالة 429). وابحث عن حدود أخرى، كعدد الملفات المرفوعة المتزامنة أو المعلّقة، وعن طريقة طلب حدود أعلى. وإن كان وضع الاختبار لدى المزوّد يطبق الحدود نفسها فجرّب دفعة مكثفة عليه أولًا.

ما الذي توثقه Fileverity. لكل مفتاح API حد في الدقيقة يشمل كل نقاط النهاية، بما فيها الطلبات التي تعيد خطأً. وتحمل كل استجابة لطلب مصادَق عليه الرؤوس x-ratelimit-limit-requests وx-ratelimit-remaining-requests وx-ratelimit-reset-requests، ويحمل الخطأ 429 rate_limited الرأس retry-after. أما السقف المستقل على الملفات المرفوعة التي لم تنتهِ صلاحيتها فيعيد الخطأ pending_files_limit دون retry-after. ويشترك مفتاح الاختبار والمفتاح الحقيقي في حدود معدل الطلبات نفسها، فتستطيع التدرب على التراجع بمفتاح اختبار. وللحصول على حدود أعلى تواصل مع فريق المبيعات. انظر: حدود المعدّل والترويسات.

البيانات والأدلة والتكلفة

الاحتفاظ بالبيانات

أهمية المعيار. الملفات المرسلة للمراجعة كثيرًا ما تحتوي على بيانات شخصية أو معلومات تجارية حساسة: صور المطالبات وقسائم الرواتب والعقود. ويصبح المزوّد جهة معالجة لهذه البيانات. وعليك أن تعرف ما الذي يُخزَّن وأين ولأي مدة ومن يستطيع الاطلاع عليه وهل يُستخدم في تدريب النماذج.

كيف تتحقق. اطلب إجابة عن كل فئة من البيانات: الملفات المرفوعة، والنص المُدخل، والبيانات المشتقة، والنتائج، والسجلات، والنسخ الاحتياطية. وعبارة «نحذف الملفات» ليست إجابة حتى تحدد ما يُحذف ومتى وما يبقى. وابحث عن جدول احتفاظ في الوثائق، ونقطة نهاية للحذف المبكر، ومواقع المعالجة وجهات المعالجة الفرعية المشاركة فيها (Subprocessors)، وبيانًا عن الاستخدام في التدريب، واتفاقية معالجة بيانات، وخيار نشر خاص. وحين تحتوي الملفات بيانات شخصية فلقوانين بلدك أحكام بشأن اختيار جهة المعالجة ونقل البيانات إلى الخارج. ومن الأمثلة:

• في المملكة العربية السعودية، يعدّ نظام حماية البيانات الشخصية «صور الفرد الثابتة أو المتحركة» من البيانات الشخصية (المادة 1)، ويلزم جهة التحكم ألا تختار إلا جهات معالجة توفر الضمانات اللازمة وأن تراقب التزامها (المادة 8). وتفصّل اللائحة التنفيذية ما يتضمنه العقد مع جهة المعالجة، ومنه الغرض من المعالجة وفئات البيانات ومدتها والتزام الجهة بإبلاغ جهة التحكم دون تأخير عند تسرب البيانات الشخصية وتحديد جهات المعالجة الفرعية (المادة 17). ويضع النظام شروطًا لنقل البيانات الشخصية إلى خارج المملكة (المادة 29). كما تمنع المادة 28 من النظام نسخ الوثائق الرسمية التي تتيح تحديد هوية أصحابها إلا بمقتضى نظامي أو بطلب من جهة عامة مختصة، وتضيف المادة 31 من اللائحة أن على جهة التحكم الامتناع عن تصوير الوثائق الرسمية الصادرة عن الجهات العامة أو نسخها في غير هاتين الحالتين، وحمايتها وإتلافها حين ينتهي الغرض ما لم يوجب النظام الاحتفاظ بها. فتحقق من السند النظامي قبل أن ترسل صور وثائق الهوية الرسمية إلى أي واجهة. (المصدر: نظام حماية البيانات الشخصية (سدايا، بالإنجليزية) ولائحته التنفيذية (بالإنجليزية)).
• في الإمارات العربية المتحدة، يتناول المرسوم بقانون اتحادي رقم 45 لسنة 2021 في شأن حماية البيانات الشخصية، النافذ منذ 2 يناير 2022، شروط نقل البيانات الشخصية ومشاركتها عبر الحدود لأغراض المعالجة (البوابة الرسمية u.ae (بالإنجليزية)). وقد تسري على المنشآت داخل المناطق المالية الحرة، مثل مركز دبي المالي العالمي، أنظمة حماية بيانات خاصة بها (قاعدة بيانات تشريعات DIFC (بالإنجليزية)).
• في مصر، تشير ملخصات قانونية إلى أن اللائحة التنفيذية لقانون حماية البيانات الشخصية رقم 151 لسنة 2020 وضعت إطارًا للتراخيص والتصاريح، وتشترط ترخيصًا أو إذنًا لنقل البيانات إلى خارج مصر، بما في ذلك البيئات السحابية (ملخص مكتب CMS (بالإنجليزية)).

هذه الإشارات للسياق وليست استشارة قانونية، ولا تعني أن أي مزوّد ملتزم بها؛ فمسؤول حماية البيانات لديك أو مستشارك القانوني هو من يقرر ما ينطبق على جهتك. وفي المشروع التجريبي تأكد من أن الملف محذوف بعد فحصه، وأن النتائج المخزنة تنتهي صلاحيتها كما تنص الوثائق.

ما الذي توثقه Fileverity. يغطي جدول الاحتفاظ في الاحتفاظ بالبيانات والأمان كل فئة من البيانات. تُحذف الملفات المرفوعة عند بدء الفحص، وعلى أي حال بعد مدة محددة، ويحذفها DELETE /files/{id} في وقت أبكر. ويُقيَّم النص المُرسل ثم يُتخلَّص منه ولا يُخزَّن أبدًا. وتُحفظ نتائج الفحوص مدة محدودة، وتُحفظ نتائج النص دون النص. وتُحفظ أدلة صفحات المستند مدة أقصر من النتيجة، فنزّل تقرير PDF عند انتهاء الفحص إن كنت تحتاج إلى الأدلة الواردة فيه. ولا تتضمن سجلات الطلبات أجسام الطلبات ولا الاستجابات. وتجد مواقع المعالجة وجهات المعالجة الفرعية في صفحة الثقة والأمان، وشروط المعالجة في اتفاقية معالجة البيانات. ويُتاح النشر الخاص لعملاء Enterprise عند الطلب، فاسأل عنه عبر صفحة الاتصال إن كانت سياسة جهتك تقيّد نقل الملفات إلى خارج بيئتها.

أدلة التدقيق وإصدارات النموذج

أهمية المعيار. حين يُعترَض على حالة مُعلَّمة بعد أشهر، عليك أن تُثبت ما فُحص ومتى وبأي إصدار من النموذج، وأن الملف لم يتغير منذ ذلك الحين. ولا تكفي درجة مجردة في قاعدة بياناتك لإثبات ذلك. وإذا غيّر المزوّد نموذجه دون إخطارك فقد تتغير النتائج على الملف نفسه، فلا تستطيع مقارنة نتيجة المشروع التجريبي بنتيجة الإنتاج ولا تفسير الفرق بين فحصين.

كيف تتحقق. ابحث عن معرّف ثابت لكل نتيجة تخزنه مع الحالة، وقيمة تجزئة للملف المفحوص، وطابع زمني موثوق من جهة إصدار الطابع الزمني (RFC 3161 (بالإنجليزية)) كي لا يعتمد الوقت على ساعة المزوّد وحدها، وتقرير قابل للتنزيل، وطريقة تتيح لطرف ثالث تأكيده دون حساب. وتأكد من أن كل نتيجة تحدد إصدار النموذج بدقة، وهل يمكنك تثبيت الطلب على إصدار ومدة بقائه متاحًا، وكيف تُعلن التغييرات وسحب الإصدارات. ويشرح دليل قيمة التجزئة SHA-256 والطوابع الزمنية الموثوقة ما تثبته قيمة التجزئة وما يثبته الطابع الزمني. وتذكّر أن الطابع الزمني الموثوق دليل تقني يربط الملف الذي فُحص بوقت محدد، أما قبوله أمام جهة قضائية أو تنظيمية فيحدده القانون المعمول به في بلدك وسياسات جهتك، فلا تفترضه واسأل مستشارك القانوني. وتحقق من المنطقة الزمنية كذلك: خزّن الأوقات بالتوقيت العالمي المنسق (UTC)، وحوّلها عند العرض إلى التوقيت المحلي (الرياض UTC+3، والإمارات UTC+4) حتى لا يُقرأ تاريخ فحص قرب منتصف الليل قراءة خاطئة.

ما الذي توثقه Fileverity. تحمل تقارير الصور والمستندات رقم التقرير وقيمة تجزئة SHA-256 للملف المفحوص وطابعًا زمنيًا وفق RFC 3161 وصفحة تحقق عامة يستطيع أي شخص لديه الرابط استخدامها دون حساب، إضافة إلى تقرير PDF مختوم. وتُكتب الأوقات داخل التقرير بصيغة ISO 8601 بالتوقيت العالمي المنسق (UTC). وتحدد كل نتيجة الإصدار الذي أنتجها، ويشير معرّف نموذج مثل fvimg-2 إلى إصدار مؤرَّخ، وإذا مرّرت معرّف إصدار مؤرَّخ في الحقل model فإن الطلب يُثبَّت عليه. وتقتصر التغييرات في الإصدار v1 على الإضافات وتُدرج في سجل التغييرات، فينبغي أن يتجاهل العميل البرمجي لديك الحقول التي لا يعرفها. وتحمل نتائج النص معرّف الكشف والإصدار الذي أنتجها. وتُحدَّد فترات الإخطار قبل سحب أي إصدار في الاتفاقية بينكما، فاطلبها كتابة. انظر: كائن التقرير، الاصطلاحات، سجل التغييرات.

الفوترة ووضع الاختبار

أهمية المعيار. قائمة الأسعار تخفي القواعد التي تحدد الفاتورة: وحدة الاحتساب، وهل تُحتسب الفحوص الفاشلة أو الملغاة أو المعاد محاولتها، وكيف تُقرَّب المبالغ، وكم قد تبلغ تكلفة مهمة خارجة عن السيطرة. وتحتاج كذلك إلى بناء التكامل واختباره دون إنفاق مال أو إفساد بيانات الإنتاج.

كيف تتحقق. ابحث عن وحدة الاحتساب لكل نوع (لكل صورة، ولكل مستند، ولكل كتلة من الأحرف) وقاعدة التقريب. وتأكد مما إذا كانت الطلبات الفاشلة والملغاة والمرفوضة تُحتسب، وهل الدفع مسبق أم باشتراك، وهل توجد حدود إنفاق وتنبيهات انخفاض الرصيد وتقرير استخدام يمكنك مطابقته بسجلاتك. واسأل عن عملة الفوترة، وعن رسوم تحويل العملة التي قد يضيفها بنكك أو بطاقة الشركة. ووضع الاختبار الجيد لا يُحتسب فيه أي رسم أبدًا، ويطبق التحقق نفسه، ويحدد بدقة ما يحاكيه وما لا يحاكيه: الزمن، وإشعارات Webhooks، والنتائج الحقيقية هي الفجوات المعتادة. وفي المشروع التجريبي طابق تقرير الاستخدام لدى المزوّد مع سجلك، ومن ذلك فحص فاشل متعمد.

ما الذي توثقه Fileverity. الواجهة مدفوعة مسبقًا من رصيد مساحة العمل، بلا اشتراك. والأسعار لكل فحص صورة ولكل فحص مستند ولكل كتلة من أحرف النص، وتُقرَّب إلى الأعلى لكل طلب. وفي فحوص الصور والمستندات يُحجز المبلغ عند إنشاء الفحص ويُفرج عنه إن فشل أو أُلغي، ولا تُحتسب الطلبات المرفوضة قبل التقييم. ويُستهلك رصيد البدء المجاني قبل رصيد مساحة العمل. ويمكن أن يكون لكل مفتاح حد إنفاق شهري بالدولار الأمريكي يُعاد ضبطه في أول كل شهر بالتوقيت العالمي (UTC)، أي في الساعة 03:00 صباحًا بتوقيت الرياض، ويُرسل عند انخفاض الرصيد تنبيه عبر البريد الإلكتروني وحدث Webhook من نوع balance.low، ويعرض كل فحص رسومه في الحقل usage. ولا تُحتسب أي رسوم على مفاتيح الاختبار ولا تستهلك رصيد البدء المجاني، وتعيد عينة ثابتة فورًا، وتطبق التحقق وحدود المعدل ورموز الأخطاء نفسها، ولا ترسل Webhooks سوى حدث الاختبار من لوحة التحكم. وتبدأ أرقام تقارير العينة بـ FV-TEST- وليس لها صفحة تحقق عامة. تجد الأسعار الحالية في الأسعار والفوترة وصفحة API (الأسعار بالدولار الأمريكي)، وسلوك مفتاح الاختبار في المصادقة والمفاتيح.

أسئلة شائعة

هل أختار واجهة متزامنة أم غير متزامنة؟

لا أفضلية لإحداهما في ذاتها. المُدخلات القصيرة كالنص العادي يناسبها الاستدعاء المتزامن، أما الملفات التي تحتاج إلى تحليل أثقل فتعيد عادة حالة أولًا. المهم أن تحدد الوثائق دورة الحياة، وأن تدعم الانتظار والاستعلام الدوري وإشعارات Webhooks، وأن تتعامل شيفرتك مع الحالة المعلَّقة.

هل أحتاج إلى Webhooks أم يكفي الاستعلام الدوري؟

يكفي الاستعلام الدوري للنموذج الأولي (Prototype) أو الحجم المنخفض. وتوفّر Webhooks الطلبات المتكررة وحصة حدود معدل الطلبات، وتناسب الإنتاج. وفي الحالتين تحقق من التوقيع وعالج التكرار والحالة المعلَّقة.

هل مفتاح عدم التكرار معيار قياسي؟

هو عُرف شائع، وتصفه مسودة من IETF (Internet-Draft) لم تصبح RFC حتى نوفمبر 2026. تعامل مع السلوك الدقيق على أنه خاص بكل مزوّد، واختبره. وسلوك Fileverity موثق في صفحة Idempotency.

هل الواجهة الجيدة تعني كاشفًا دقيقًا؟

لا. هذه المعايير تغطي التكامل لا جودة الكشف. قيّم الكشف على ملفاتك أنت، بتصنيفات مرجعية تثق بها، مستعينًا بـدليل الدقة ودليل الشراء.

هل تكشف الواجهة النصوص العربية المكتوبة بالذكاء الاصطناعي؟

لا. يقبل كشف النص في Fileverity الإنجليزية والفرنسية والألمانية والإسبانية والصينية فقط، ويرفض الطلب الذي لغته غير مدعومة بالخطأ unsupported_language. أما الصور والمستندات العربية فاختبرها على عينات تمثل ملفاتك في المشروع التجريبي، ولا تبنِ قرارًا على افتراض مسبق.

هل يجوز إرسال بيانات شخصية أو صور هويات إلى واجهة خارج بلدي؟

يتوقف الجواب على قانون بلدك وطبيعة البيانات ودور جهتك، ولا يغني هذا الدليل عن رأي مستشارك القانوني. اقرأ قسم الاحتفاظ بالبيانات، وأرسل أقل قدر لازم من البيانات، واطلب اتفاقية معالجة البيانات وقائمة جهات المعالجة الفرعية، واسأل عن النشر الخاص عند الحاجة، واعرض القرار على مسؤول حماية البيانات.

هل أستطيع تجربة واجهة Fileverity دون دفع؟

نعم. تتضمن مساحة العمل الأولى لديك رصيد البدء المجاني، ولا تُحتسب أي رسوم على مفاتيح الاختبار أبدًا. اتبع البدء السريع وراجع الأسعار والفوترة (كلاهما بالإنجليزية) لمعرفة الشروط.

قائمة فحص للمشروع التجريبي

أجرِ المشروع التجريبي على ثلاث مراحل، ودوّن كل إجابة بتاريخها. الأولى مراجعة مكتبية: أجب عن المعايير العشرة من وثائق كل مرشح، واستبعد حالات عدم التوافق الواضحة قبل كتابة أي شيفرة. الثانية مرحلة مفتاح الاختبار: ابنِ التكامل على وضع الاختبار. الثالثة مرحلة المفتاح الحقيقي: استخدم مفتاحًا حقيقيًا بحد إنفاق منخفض وعينة من الملفات المصرّح لك بإرسالها. أما أخذ العينات ووضع التصنيفات المرجعية وقياس جودة الكشف نفسها فاتبع فيها تصميم المشروع التجريبي في دليل اختيار برنامج كشف الصور المولَّدة بالذكاء الاصطناعي.

احتفظ بالإجابات إلى جانب مصفوفة التغطية وطريقة تسجيل النقاط في دليل الشراء. وللبدء مع Fileverity اقرأ صفحة API وصفحتي كشف الصور والمستندات وصفحة البدء السريع.

بقلم Yang Zheng · مراجعة Bill Liu