انتقل إلى المحتوى

واجهة API لكشف تزوير المستندات

واجهة API لكشف تزوير المستندات بصيغتي PDF وWord.

افحص ملفات PDF وWord بحثًا عن التعديل والتزوير والنص المكتوب بالذكاء الاصطناعي باستدعاءين عبر API، بتكلفة ⁦US$ 5.99⁩ للمستند.

ابدأ مجانًااقرأ التوثيق

رصيد البدء المجاني: 5 من فحوصات الصور أو المستندات و5,000 حرف نصي. بلا بطاقة وبلا اشتراك.

نظرة سريعةfvdoc-3
نقاط النهاية
POST /v1/files, POST /v1/analyses
النموذج
fvdoc-3 · FVDOC V3
الملفات المقبولة
PDF, DOCX, DOC, RTF, ODT, PPTX, TXT
الحجم الأقصى
حتى 50 ميغابايت و100 صفحة
النتيجة
انتظرها في الطلب نفسه، أو استقبل Webhook
السعر
⁦US$ 5.99⁩ لكل فحص مستند

آخر تحديث

ما يفحصه

ما الذي يفحصه فحص المستند.

كل مؤشر جزء من التقرير نفسه الذي تحصل عليه في لوحة التحكم. ويدلّك عمود حقل الاستجابة على موضع قراءته.

المؤشرات التي يفحصها فحص المستند وحقول الاستجابة التي تحملها
المؤشرما يُفحصحقل الاستجابة
سجل التعديلات وبنية الملفالنسخ المحفوظة والصفحات المعدَّلة والمضافة وطريقة تجميع الملف.structure
التوقيعات وسجلات الملفالتوقيعات الرقمية وسجلات الإنشاء والتعديل والبرنامج المذكور في الملف.provenance
الصور المضمَّنةالصور داخل المستند، تُفحص كل منها بحثًا عن التوليد بالذكاء الاصطناعي والتعديلات الموضعية.images
النص المكتوب بالذكاء الاصطناعيتصنيف لنص المستند، مع تعليم الفقرات المكتوبة بالذكاء الاصطناعي بحسب الصفحة. يدعم الإنجليزية والفرنسية والألمانية والإسبانية والصينية فقط.text
المؤشرات والخطوة التاليةالمؤشرات التي استند إليها مستوى المخاطر، ومدى قوة كل منها، والإجراء الموصى به.findings, level, action

الطلب والاستجابة

استدعاءان وتقرير واحد.

ارفع الملف ثم أنشئ الفحص بالنموذج fvdoc-3. أرسل Prefer: wait لإبقاء الطلب مفتوحًا حتى يصبح التقرير جاهزًا. قد تُوضَع المستندات في قائمة انتظار، فتأتي استجابة الفحص بالرمز 202 والحالة processing. اجلب النتيجة لاحقًا أو استقبل Webhook.

الطلبPOST /v1/files, POST /v1/analyses
FILE_ID=$(curl -s https://api.fileverity.com/v1/files \  -H "Authorization: Bearer $FILEVERITY_API_KEY" \  -F file=@contract.pdf | jq -r .id) curl https://api.fileverity.com/v1/analyses \  -H "Authorization: Bearer $FILEVERITY_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Prefer: wait=60" \  -d "{\"model\": \"fvdoc-3\", \"file\": \"$FILE_ID\"}"
الاستجابة200 OK
{  "id": "an_Zc4vB7nP1sK8tL3wR6yQm2Xa",  "object": "analysis",  "created": 1793700300,  "model": "fvdoc-3-2026-11-03",  "livemode": true,  "status": "succeeded",  "file": {    "name": "contract.pdf",    "bytes": 18874368,    "format": "pdf"  },  "report_id": "FV-3PXH-6WQ2-8NDC",  "report_url": "https://fileverity.com/verify/FV-3PXH-6WQ2-8NDC",  "summary": {    "kind": "docpro",    "level": "L3",    "action": "review",    "reason": null,    "findings": [],    "pages": 12,    "images": 3,    "text": "human"  },  "result": {    "report": {      "schema": "fileverity.docpro/1",      "id": "FV-3PXH-6WQ2-8NDC"    },    "stamped_at": 1793700340  },  "error": null,  "progress": null,  "usage": {    "amount": 599,    "currency": "usd",    "funding": "balance"  },  "metadata": null,  "completed_at": 1793700341,  "expires_at": 1794305141}
يرفع الطلب الأول الملف، وينشئ الطلب الثاني الفحص. وتُظهر الاستجابة فحصًا مكتملًا.

حالات الاستخدام

ضعه حيث يتحول الملف إلى قرار.

تعيد API مستوى المخاطر والإجراء الموصى به. ويبقى القرار النهائي لمراجعيك.

الحدود

ما لا يفعله.

النتيجة النظيفة تضيّق نطاق المراجعة ولا تحل محلها.

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

الأدلة

أدلة يمكنك الاحتفاظ بها.

يترك كل فحص سجلًا يمكنك حفظه ومشاركته والتحقق منه لاحقًا، لا مجرد حكم.

  • رقم التقرير

    رقم تقرير بصيغة FV-XXXX-XXXX-XXXX. احتفظ به مع ملف القضية أو سجل العميل لديك.

  • قيم التجزئة والطابع الزمني

    تُسجَّل مع كل تقرير قيم التجزئة SHA-256 للملف والتقرير وطابع زمني وفق RFC 3161.

  • صفحة تحقق عامة

    يستطيع كل من تشاركه رقم التقرير تأكيده في صفحة التحقق دون حساب.

  • تُحذف الملفات وتبقى النتائج

    تُحذف الملفات المرفوعة بعد الفحص ولا تُستخدم أبدًا في تدريب النماذج. وتبقى النتيجة متاحة عبر API لمدة 7 أيام.

التكامل

ادمجها في مسار عملك.

يتبع فحص الصور والمستندات النمط نفسه، فيغطي تكامل واحد النوعين.

  • انتظر النتيجة عبر Prefer: wait، أو استقبل Webhook موقَّعًا عند انتهاء الفحص. وتعامل مع استجابة الفحص المكتمل واستجابة المعالجة (processing) معًا.
  • أرسل Idempotency-Key مع كل طلب POST، حتى لا تؤدي إعادة المحاولة إلى تنفيذ الفحص مرتين.
  • ابدأ ببناء التكامل على مفاتيح fv_test_. فهي تعيد نتائج تجريبية ثابتة ولا تُحتسب عليها أي رسوم.
  • لا تُحتسب رسوم على عمليات الفحص الفاشلة. وعند انشغال الخدمة تعيد الرمز 503 مع ترويسة retry-after، فأعد المحاولة بالمفتاح نفسه.
  • تُوقَّع Webhooks وتتبع مواصفات Standard Webhooks.
  • تُرسل الملفات حتى 4 ميغابايت في طلب multipart واحد. أما الملفات الأكبر فتستخدم رابط رفع موقَّعًا مسبقًا (pre-⁠signed)، على ألا تتجاوز الحد الأقصى للنموذج.
  • الحد الأقصى للطلبات 120 في الدقيقة لكل مفتاح.

الأسعار

ادفع مقابل كل فحص.

يغطي رصيد واحد مدفوع مسبقًا لمساحة العمل فحوصات الصور والمستندات والنصوص. أضف رصيدًا بدءًا من ⁦US$ 19⁩. لا يوجد اشتراك ولا تجديد تلقائي.

أسعار API ولوحة التحكم
الفحصالسعر
فحص صورةيُحتسب لكل صورة⁦US$ 1.99⁩
فحص مستنديُحتسب لكل مستند⁦US$ 5.99⁩
فحص نصيُحتسب لكل 1,000 حرف⁦US$ 0.14⁩

يُقرَّب النص إلى أقرب 1,000 حرف للأعلى في كل طلب. يتطلب فحص النص 100 كلمة على الأقل.

رصيد البدء المجاني

جرّب قبل أن تضيف رصيدًا.

تبدأ مساحة العمل الأولى لديك بعدد 5 من فحوصات الصور أو المستندات المجانية، إضافةً إلى 5,000 حرف نصي مجاني.

لا حاجة إلى بطاقة للبدء. رصيد بدء مجاني واحد لكل شخص، وعدد محدود لكل نطاق بريد إلكتروني خاص بالشركة. وعلى زملاء الفريق الانضمام عبر دعوة.

الأسئلة الشائعة

كيف أكشف ملف PDF مزوَّرًا عبر API؟

ارفع ملف PDF عبر POST /v1/files، ثم أنشئ فحصًا عبر POST /v1/analyses بالنموذج fvdoc-3. تحمل الاستجابة مؤشرات مستمدة من سجل تعديلات الملف وتوقيعاته وصوره المضمَّنة ونصه، إضافةً إلى مستوى المخاطر والإجراء الموصى به ورقم تقرير يمكن لأي شخص التحقق منه.

هل يستطيع كشف المستندات المولَّدة بالذكاء الاصطناعي؟

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

هل يتحقق من الهويات أو جوازات السفر؟

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

كم تبلغ تكلفة فحص المستند؟

⁦US$ 5.99⁩ لكل فحص مستند، تُدفع من رصيد مساحة العمل المدفوع مسبقًا الذي تضيفه بدءًا من ⁦US$ 19⁩. لا يوجد اشتراك. ولا تُحتسب رسوم على عمليات الفحص الفاشلة ولا على مفاتيح الاختبار.

هل يمكنني التجربة مجانًا، وهل يوجد وضع اختبار؟

تبدأ مساحة العمل الأولى لديك بعدد 5 من عمليات فحص الصور أو المستندات المجانية، إضافةً إلى 5,000 حرف نصي مجاني، ولا حاجة إلى بطاقة. يتوفر رصيد بدء مجاني واحد لكل شخص وعدد محدود لكل نطاق بريد إلكتروني لشركة. أما المفاتيح التي تبدأ بالبادئة fv_test_ فتعيد نتائج تجريبية ثابتة ولا تُحتسب عليها رسوم أبدًا.

ما صيغ الملفات والأحجام المقبولة؟

الصيغ المقبولة: PDF, DOCX, DOC, RTF, ODT, PPTX, TXT. الحدود هي 50 ميغابايت و100 صفحة للملف الواحد. تُرسل الملفات حتى 4 ميغابايت في طلب multipart واحد، وتستخدم الملفات الأكبر رابط رفع موقَّعًا مسبقًا. أما صورة بصيغة JPEG أو PNG أو WebP لمستند فتُعدّ فحص صورة.

إلى متى تُحفظ الملفات والنتائج؟

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

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

إرشادات عملية لفرق المراجعة.

ما الذي يُظهره كل فحص، وأين يتوقف، وأي دليل تطلبه بعد ذلك.

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

أجرِ أول فحص لك خلال دقائق.

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