توثيق واجهة Fileverity API
الاحتفاظ بالبيانات والأمان
ما الذي تخزّنه Fileverity API ولأي مدة: الملفات المرفوعة والنتائج والنصوص وسجلات الطلبات وعمليات تسليم Webhook، وكيف تُحمى المفاتيح ونقاط النهاية.
عرض بصيغة Markdownآخر تحديث: 2026-11-04
تعرض هذه الصفحة ما تحتفظ به API ومدة الاحتفاظ به. وللاطلاع على الصورة الأشمل، راجع الثقة والأمان.
الاحتفاظ
| البيانات | مدة الاحتفاظ | ملاحظات |
|---|---|---|
| الملفات المرفوعة | تُحذف عند بدء التحليل، وبعد 24 ساعة على أبعد تقدير | تُخزَّن بصورة خاصة. ويحذف DELETE /files/{id} الملف في وقت أبكر. |
النص الذي ترسله إلى POST /text/detections | لا يُخزَّن | يُقيَّم ثم يُحذف. ولا يُخزَّن إطلاقًا، لذلك لا يمكن استرجاعه لاحقًا. |
| نتائج كشف النصوص (دون النص أبدًا) | 7 أيام | الحكم والدرجات وإزاحات الفقرات والاستخدام. وتظهر في الفحوصات السابقة في لوحة التحكم. ولا تسجّل مفاتيح الاختبار شيئًا. |
| نتائج التحليل | 7 أيام | بعد ذلك تُحذف النتيجة. ويظل سجل التحقق الخاص بالتقرير متاحًا. |
| أدلة المستند (صور الصفحات ومقتطفات النص) | 3 ساعات | نزّل تقرير PDF قبل ذلك للاحتفاظ بالأدلة الواردة فيه. |
| سجلات الطلبات | 30 يومًا | الطريقة والمسار والحالة والمدة ورمز الخطأ والمفتاح. ولا تشمل محتوى الطلبات أو الاستجابات. |
| سجلات تسليم Webhook | 30 يومًا | محتوى الطلب الخاص بالحدث، والحالة، وزمن الاستجابة، وأول 2 كيلوبايت من استجابة نقطة النهاية لديك. وتُعرض آخر 50 عملية تسليم في لوحة التحكم. |
| سجلات Idempotency | 24 ساعة | الاستجابة المحفوظة، وتُستخدم لإعادتها عند إعادة إرسال الطلب. وفي حالة كشف النصوص تكون هي النتيجة دون النص. |
الحماية
- HTTPS فقط. تستخدم جميع الاتصالات مع API بروتوكول HTTPS.
- المفاتيح. لا يُخزَّن من المفتاح سوى قيمة تجزئة SHA-256 وآخر أربعة أحرف منه. ويمكن إبطال المفاتيح في أي وقت. راجع المصادقة والمفاتيح.
- عزل مساحات العمل. تتبع الملفات والتحليلات والمفاتيح وWebhooks والسجلات مساحة عمل واحدة ووضعًا واحدًا؛ ولا يستطيع المفتاح الحقيقي ومفتاح الاختبار قراءة ملفات أحدهما الآخر.
- حدود الإنفاق. تضع الحدود الشهرية لكل مفتاح سقفًا لما يمكن أن ينفقه مفتاح مسرَّب.
- Webhooks. تُوقَّع عمليات التسليم بمفتاح سري خاص بكل نقطة نهاية. ويجب أن تستخدم نقاط النهاية HTTPS وعناوين عامة؛ وتُرفض العناوين الخاصة والداخلية. ولا تُتّبع عمليات إعادة التوجيه.
- تقارير قابلة للتحقق. تحمل تقارير الصور والمستندات رقم تقرير وقيم تجزئة SHA-256 وطابعًا زمنيًا وفق RFC 3161، ولها صفحة تحقق عامة.
Enterprise
يتوفر النشر الخاص لعملاء Enterprise عند الطلب. تواصل معنا لمناقشته.