# نظرة عامة

> تفحص واجهة Fileverity API الصور والمستندات والنصوص العادية بحثًا عن التوليد بالذكاء الاصطناعي والتلاعب والفقرات المكتوبة بالذكاء الاصطناعي. عنوان URL الأساسي والنماذج والاصطلاحات ونقطة البداية.

المصدر: https://fileverity.com/ar/docs

تتيح واجهة Fileverity API لبرمجياتك فحص الصور والمستندات والنصوص العادية بنماذج Fileverity. ويغطي مفتاح API واحد ورصيد مساحة عمل واحد مدفوع مسبقًا جميع النماذج. ونتائج الصور والمستندات هي التقارير نفسها التي ينتجها الموقع، ويحمل كل تقرير منها رقم تقرير وطابعًا زمنيًا وفق RFC 3161 وصفحة تحقق عامة.

هل أنت جديد هنا؟ اتبع [البدء السريع](https://fileverity.com/ar/docs/quickstart.md) لتجري أول استدعاء خلال دقائق، أو [احصل على مفتاح اختبار](https://fileverity.com/console/keys?lang=ar) وابدأ باستدعاء API فورًا. وللاطلاع على نظرة عامة على المنتج، راجع [صفحة API](https://fileverity.com/ar/api) و[واجهة API لكشف الصور المولَّدة بالذكاء الاصطناعي](https://fileverity.com/ar/api/ai-image-detection) و[واجهة API لكشف تزوير المستندات](https://fileverity.com/ar/api/document-fraud-detection).

## النماذج

| النموذج | ما يفحصه | طريقة الاستدعاء |
| --- | --- | --- |
| `fvimg-2` (FVIMG V2) | الصور: التوليد بالذكاء الاصطناعي والتعديلات الموضعية وبيانات Content Credentials والبيانات الوصفية. نظرة عامة: [واجهة API لكشف الصور المولَّدة بالذكاء الاصطناعي](https://fileverity.com/ar/api/ai-image-detection) | ارفع الملف عبر [`POST /files`](https://fileverity.com/ar/docs/files.md)، ثم استدعِ [`POST /analyses`](https://fileverity.com/ar/docs/analyses.md) |
| `fvdoc-3` (FVDOC V3) | المستندات: النص المكتوب بالذكاء الاصطناعي والصور المضمَّنة وسجل التعديلات والتوقيعات. نظرة عامة: [واجهة API لكشف تزوير المستندات](https://fileverity.com/ar/api/document-fraud-detection) | ارفع الملف عبر [`POST /files`](https://fileverity.com/ar/docs/files.md)، ثم استدعِ [`POST /analyses`](https://fileverity.com/ar/docs/analyses.md) |
| `fvdoc-3-text` (FVDOC V3 Text) | نص عادي: مكتوب بالذكاء الاصطناعي أو مكتوب جزئيًا بالذكاء الاصطناعي أو كتبه إنسان، مع تعليم الفقرات المكتوبة بالذكاء الاصطناعي | استدعاء متزامن واحد إلى [`POST /text/detections`](https://fileverity.com/ar/docs/text-detections.md) |

الأسعار والحدود ومعرّفات النسخ المؤرَّخة مدرجة في [الأسعار والفوترة](https://fileverity.com/ar/docs/pricing.md).

## الاصطلاحات

- **عنوان URL الأساسي.** `https://api.fileverity.com/v1`. عبر HTTPS فقط.
- **الصيغة.** الطلبات بصيغة JSON، باستثناء رفع الملفات فهي بصيغة multipart. والاستجابات بصيغة JSON، باستثناء تقرير PDF. الطوابع الزمنية بصيغة Unix بالثواني، باستثناء ما داخل `result.report` حيث تُكتب الأوقات بصيغة ISO 8601 بالتوقيت العالمي المنسق (UTC).
- **المصادقة.** مفتاح API من نوع Bearer في ترويسة `Authorization`. راجع [المصادقة والمفاتيح](https://fileverity.com/ar/docs/authentication.md).
- **المعرّفات.** تحمل الكائنات بادئة: `file_` للملفات، و`an_` للتحليلات، و`tdet_` لعمليات كشف النصوص، و`evt_` لأحداث Webhook، و`req_` للطلبات. وتبدو أرقام التقارير بهذا الشكل: `FV-XXXX-XXXX-XXXX`.
- **معرّفات الطلبات.** تحمل كل استجابة ترويسة `x-request-id`، ويكرر كل خطأ المعرّف نفسه في `error.request_id`. اذكره عندما [تتواصل مع الدعم](https://fileverity.com/ar/contact).
- **الفحوصات والتحليلات والتقارير.** الفحص هو ما تجريه وتدفع مقابله: فحص صورة أو فحص مستند أو فحص نص. وفي API، التحليل هو فحص صورة أو مستند واحد، وعملية كشف النص هي فحص نص واحد. ينتج عن فحص الصور والمستندات تقرير كامل، وينتج عن فحص النص نتيجة.
- **الإصدارات.** رقم الإصدار موجود في عنوان URL. يمكن إضافة حقول ونقاط نهاية جديدة إلى v1، لذا تجاهل الحقول التي لا تعرفها. يشير معرّف النموذج مثل `fvimg-2` إلى نسخة مؤرَّخة (`fvimg-2-2026-10-30`). تُبيّن النتائج النسخة التي أنتجتها، ويمكنك تثبيت الطلب على نسخة مؤرَّخة بتمرير معرّفها في `model`.
- **اللغات.** يقبل كشف النص: الإنجليزية (en) والفرنسية (fr) والألمانية (de) والإسبانية (es) والصينية (zh).

## مواصفات OpenAPI

تُوصَف الواجهة بوثيقة OpenAPI 3.1 على العنوان [https://api.fileverity.com/v1/openapi.json](https://api.fileverity.com/v1/openapi.json). ويُولَّد [مرجع API](https://fileverity.com/ar/docs/api-reference.md) من تلك الوثيقة، فيتطابق الاثنان دائمًا. ويمكن تحميل الوثيقة من متصفح، لذلك تستطيع أدوات مثل Swagger UI وPostman استيرادها عبر عنوان URL، ويعيد `GET https://api.fileverity.com/v1` روابط إلى هذا التوثيق وإلى المواصفات.

## محتويات هذا التوثيق

- [البدء السريع](https://fileverity.com/ar/docs/quickstart.md): من التسجيل حتى أول نتيجة.
- [المصادقة والمفاتيح](https://fileverity.com/ar/docs/authentication.md): المفاتيح الحقيقية ومفاتيح الاختبار، والإبطال، وحدود الإنفاق.
- [كشف النصوص](https://fileverity.com/ar/docs/text-detections.md) و[الملفات](https://fileverity.com/ar/docs/files.md) و[التحليلات](https://fileverity.com/ar/docs/analyses.md): طرق إجراء الفحص.
- [Webhooks](https://fileverity.com/ar/docs/webhooks.md) و[Idempotency](https://fileverity.com/ar/docs/idempotency.md): السلوك في بيئة الإنتاج.
- [أمثلة برمجية](https://fileverity.com/ar/docs/sample-code.md): برامج كاملة بلغتي Node.js وPython لكل فحص وللتعامل مع Webhooks.
- [فحص المستندات في سير عمل الاستقبال](https://fileverity.com/ar/docs/intake-workflow.md): الرفع وWebhook والتوجيه بحسب مستوى المخاطر والمراجعة البشرية والتحقق اللاحق.
- [الأخطاء](https://fileverity.com/ar/docs/errors.md) و[حدود المعدّل والترويسات](https://fileverity.com/ar/docs/rate-limits.md).
- [الأسعار والفوترة](https://fileverity.com/ar/docs/pricing.md) و[الاحتفاظ بالبيانات والأمان](https://fileverity.com/ar/docs/security.md).
- [سجل التغييرات](https://fileverity.com/ar/docs/changelog.md) و[مرجع API](https://fileverity.com/ar/docs/api-reference.md).

## الفحوصات نفسها في المتصفح

لا تحتاج إلى API لإجراء فحص. يقدّم الموقع [افحص صورة](https://fileverity.com/ar/ai-image-detector) و[التحقق من المستندات](https://fileverity.com/ar/ai-document-detector) و[التحقق من الصور](https://fileverity.com/ar/image-verification)، وتُجري [لوحة التحكم](https://fileverity.com/console?lang=ar) الفحوصات الثلاثة كلها من رصيد مساحة عملك.

## الدعم

راسل [hello@fileverity.com](mailto:hello@fileverity.com) أو استخدم [صفحة التواصل](https://fileverity.com/ar/contact)، واذكر معرّف الطلب (`x-request-id`) والوقت بالتوقيت العالمي المنسق (UTC) ونقطة النهاية. تعيد حالات الفشل المؤقتة `503 service_unavailable` مع ترويسة `retry-after` ولا تُحتسب عليها رسوم أبدًا. هل تحتاج إلى حدود أعلى أو تسعير بحسب الحجم؟ [تواصل مع فريق المبيعات](https://fileverity.com/ar/contact).

## قراءة هذا التوثيق عبر وكيل ذكاء اصطناعي

تتوفر كل صفحة أيضًا بصيغة Markdown: أضف `.md` إلى مسارها، مثل `/ar/docs/quickstart.md`. وفهرس جميع الصفحات على [/ar/docs/llms.txt](https://fileverity.com/ar/docs/llms.txt).