# توثيق واجهة Fileverity API

> توثيق المطوّرين لواجهة Fileverity API: افحص الصور والمستندات والنصوص العادية بحثًا عن التوليد بالذكاء الاصطناعي والتلاعب والفقرات المكتوبة بالذكاء الاصطناعي. وتتوفر كل صفحة أيضًا بصيغة Markdown على المسار نفسه مع إضافة .md.

## نظرة سريعة

- عنوان URL الأساسي: `https://api.fileverity.com/v1` (HTTPS فقط، وصيغة JSON).
- المصادقة: مفتاح API من نوع Bearer في الترويسة `Authorization`. تبدأ المفاتيح الحقيقية بالبادئة `fv_live_`؛ وتبدأ مفاتيح الاختبار بالبادئة `fv_test_`، وتعيد نتائج نموذجية ثابتة ولا تُحتسب عليها رسوم أبدًا.
- فحص الصور: النموذج `fvimg-2` (FVIMG V2)، ⁦US$ 1.99⁩ لكل صورة. ارفع الملف باستخدام `POST /files` ثم `POST /analyses`.
- فحص المستندات: النموذج `fvdoc-3` (FVDOC V3)، ⁦US$ 5.99⁩ لكل مستند. ارفع الملف باستخدام `POST /files` ثم `POST /analyses`.
- فحص النصوص: النموذج `fvdoc-3-text` (FVDOC V3 Text)، ⁦US$ 0.14⁩ لكل 1,000 حرف، بحد أدنى 100 كلمة. استدعاء متزامن واحد إلى `POST /text/detections`.

الدفع في API مسبق وبلا اشتراك: أضف رصيدًا إلى مساحة عملك بدءًا من ⁦US$ 19⁩. تبدأ مساحة عملك الأولى بعدد 5 من فحوصات الصور أو المستندات المجانية، إضافةً إلى 5,000 حرف نصي مجاني. ولا تُحتسب رسوم على عمليات الفحص الفاشلة. ويظل الرصيد صالحًا مدة 12 شهرًا بعد آخر عملية إضافة رصيد لديك، وعمليات إضافة الرصيد غير قابلة للاسترداد إلا حيث يقتضي القانون ذلك أو ينص عليه اتفاقك. تُحذف الملفات المرفوعة عند بدء التحليل، وبعد 24 ساعة على أبعد تقدير. ولا يُخزَّن النص الذي ترسله. وتُحفظ النتائج 7 أيام.

## البدء

- [نظرة عامة](https://fileverity.com/ar/docs.md): تفحص واجهة Fileverity API الصور والمستندات والنصوص العادية بحثًا عن التوليد بالذكاء الاصطناعي والتلاعب والفقرات المكتوبة بالذكاء الاصطناعي. عنوان URL الأساسي والنماذج والاصطلاحات ونقطة البداية.
- [البدء السريع](https://fileverity.com/ar/docs/quickstart.md): أنشئ مساحة عمل ومفتاح API ونفّذ أول فحص لنص وأول فحص لصورة باستخدام cURL أو JavaScript fetch أو Python requests.
- [المصادقة والمفاتيح](https://fileverity.com/ar/docs/authentication.md): المصادقة بمفاتيح API من نوع Bearer. المفاتيح الحقيقية ومفاتيح الاختبار، وما يعيده وضع الاختبار، وإبطال المفتاح، وتحديد حد إنفاق شهري لكل مفتاح.

## الأدلة الإرشادية

- [كشف النصوص](https://fileverity.com/ar/docs/text-detections.md): صنّف النص العادي بوصفه مكتوبًا بالذكاء الاصطناعي أو مختلطًا أو كتبه إنسان باستخدام POST /text/detections. حقول الطلب والاستجابة، وإزاحات المقاطع، والحدود، والفوترة.
- [الملفات](https://fileverity.com/ar/docs/files.md): ارفع الصور والمستندات إلى Fileverity: multipart للملفات حتى 4 ميغابايت، ورفع بعنوان موقّع مسبقًا للملفات حتى 50 ميغابايت. كائن الملف والحدود والاحتفاظ.
- [التحليلات](https://fileverity.com/ar/docs/analyses.md): أنشئ تحليلات الصور والمستندات، وانتظر النتيجة عبر Prefer: wait أو بالاستعلام المتكرر، وألغِ التحليل، ونزّل تقرير PDF، واقرأ كائن التقرير وصفحة التحقق.
- [Webhooks](https://fileverity.com/ar/docs/webhooks.md): استقبل أحداث analysis.completed وanalysis.failed وbalance.low. التحقق من توقيع Standard Webhooks بلغتي JavaScript وPython، وإعادة المحاولة، والتعطيل التلقائي، وحدث الاختبار.
- [Idempotency](https://fileverity.com/ar/docs/idempotency.md): أرسل Idempotency-Key مع طلبات POST حتى لا تؤدي إعادة إرسال الطلب إلى تنفيذ الفحص أو احتساب رسمه مرتين. شرح السلوك والاستجابات المُعادة والتعارضات.
- [أمثلة برمجية](https://fileverity.com/ar/docs/sample-code.md): برامج كاملة على Node.js وPython لواجهة Fileverity API: فحص صورة، وفحص ملف PDF كبير، وكشف النص المكتوب بالذكاء الاصطناعي، والتحقق من توقيعات Webhook.
- [فحص المستندات في سير عمل الاستقبال](https://fileverity.com/ar/docs/intake-workflow.md): أضف فحص المستندات إلى مسار الاستقبال: الرفع، واستقبال Webhook، والتوجيه بحسب مستوى المخاطر، وإدراج الحالات في قائمة المراجعة البشرية، وتخزين رقم التقرير، والتحقق منه لاحقًا.
- [الأخطاء](https://fileverity.com/ar/docs/errors.md): صيغة الأخطاء في Fileverity API، ورموز حالة HTTP، والجدول الكامل لرموز الأخطاء، مع إرشادات حول الأخطاء التي تستحق إعادة المحاولة.
- [حدود المعدّل والترويسات](https://fileverity.com/ar/docs/rate-limits.md): حدود معدّل الطلبات لكل مفتاح API، وترويسات الاستجابة الخاصة بحدود المعدّل، وretry-after عند 429 و503، والترويسات الأخرى التي ترسلها Fileverity API.
- [الأسعار والفوترة](https://fileverity.com/ar/docs/pricing.md): نماذج Fileverity API وأسعارها وحدودها، والرصيد المدفوع مسبقًا وصلاحيته واسترداده، ورصيد البدء المجاني، وحدود الإنفاق، وإعادة الشحن التلقائي، وتنبيهات انخفاض الرصيد.
- [الاحتفاظ بالبيانات والأمان](https://fileverity.com/ar/docs/security.md): ما الذي تخزّنه Fileverity API ولأي مدة: الملفات المرفوعة والنتائج والنصوص وسجلات الطلبات وعمليات تسليم Webhook، وكيف تُحمى المفاتيح ونقاط النهاية.

## المرجع

- [مرجع API](https://fileverity.com/ar/docs/api-reference.md): جميع نقاط نهاية Fileverity API مع المعلمات ومخططات الطلبات والاستجابات ورموز الأخطاء والأمثلة، مولَّدة من مواصفة OpenAPI 3.1.
- [سجل التغييرات](https://fileverity.com/ar/docs/changelog.md): التغييرات في Fileverity API. أُطلق الإصدار 1 في نوفمبر 2026.

## للقراءة الآلية

- [مواصفة OpenAPI بالإصدار 3.1](https://api.fileverity.com/v1/openapi.json): مصدر مرجع API.
- [جميع صفحات التوثيق في ملف واحد](https://fileverity.com/ar/docs/llms-full.txt): كل الصفحات المذكورة أعلاه، مدمجة بصيغة Markdown.