النص والنتيجة معًا
تحتاج بنية REST إلى حقل نصي واحد، مما يسهّل إضافتها إلى مسار قائم لاستقبال المواد أو تحريرها.
REST API / تحليل الانتحال
واجهة API لمدقق الانتحال لمراجعة تراعي المصادر
أضف تحليل الانتحال إلى منتج الكتابة أو التعليم أو النشر دون إرسال المراجعين إلى أداة منفصلة. أرسل النص من الخادم الخاص بك وأعد النتيجة إلى سير العمل الذي يستخدمونه بالفعل.
استخدم المفتاح من بيئة خادم خاص.
طلب cURL
curl --request POST \
--url https://api.detecting-ai.com/api/plagiarism/ \
--header "Content-Type: application/json" \
--header "Idempotency-Key: plagiarism-review-001" \
--header "X-API-Key: YOUR_API_KEY" \
--data '{
"text": "Paste the text you want to check."
}'01
طلبات POST إلى /api/plagiarism/
02
المصادقة عبر X-API-Key
03
مفتاح Idempotency-Key يحدده العميل لإعادة المحاولات بأمان
04
حقل نصي واحد مطلوب
05
رصيد كلمات مستقل للميزة
احتفظ بالمصدر في المحادثة
يكون التشابه مفيدًا عندما يتمكن المراجع من التحقق من سبب ظهوره
تمنح API منتجك نتيجة لفحص الانتحال وبيانات الاستخدام. وينبغي أن تعرض واجهتك هذه النتيجة مع المقطع المرسل وسياق المصدر المتاح والقواعد المهمة للمراجع.
من جانب الخادم أساسًا
احتفظ بمفتاح العميل خارج المتصفح، ولا تُعد إلا بيانات التقرير التي يستطيع تطبيقك شرحها.
المراجعة قبل الإجراء
تعامل مع التداخل كدليل للتحقق من المصدر. لا يزال الاستشهاد والإذن والسياسة يحددان معنى المطابقة.
بنية الطلب
لنص الطلب مهمة واحدة
أرسل النص الكامل الذي تريد التحقق منه كسلسلة JSON. تعامل مع تحليل المستندات والتحكم في الوصول وأي بيانات وصفية للإرسال في تطبيقك الخاص.
| حقل | النوع | مطلوب | ماذا يفعل |
|---|---|---|---|
| text | string | نعم | النص الذي تريد خدمة الانتحال تحليله. |
افحص النتيجة المعادة قبل تصميم واجهة المستخدم
يحمل حقل result التحليل، ويسجل words_processed مقدار الاستخدام. احتفظ بالاستجابة الخام في سجل اختبار خاص حتى تتعامل عملية ربط الحقول مع النتائج العادية والفارغة.
مثال للرد
{
"result": "Plagiarism analysis is returned here",
"words_processed": 8
}مسار التكامل
ابدأ بحلقة مراجعة صغيرة يمكن تتبعها
التكامل الواضح يبقي النص المقدم والتحليل وإجراء المراجع متصلين.
- 1
أنشئ اتصال خادم خاص
خزّن مفتاح API بوصفه سرًا، ولا تقبل النص إلا من المستخدمين والأنظمة التي يصرح لها تطبيقك.
- 2
أرسل مستندات واقعية
احفظ Idempotency-Key فريدًا، ثم اختبر مستندات ومقالات وقوائم واقعية ومواد مقتبسة أو موثقة. ولا تعد استخدام المفتاح إلا للمحاولة نفسها بالضبط.
- 3
صمّم حالة المراجعة
أظهر ما يكفي من سياق المصدر والمقطع حتى يتمكن الشخص من فهم المطابقة قبل وضع علامة عليها أو رفضها أو تصعيدها.
حالات مناسبة
مصمم لقوائم الانتظار حيث تكون الأصالة مهمة بالفعل
ينتمي API إلى جانب المستند وسجله. فهذا يسهل التحقيق في التطابق، ويمنع تحويل النسبة المئوية إلى حكم نهائي.
المطابقة تحتاج إلى سياق
قد تسبب الاقتباسات والمراجع والعبارات المألوفة والمواد المرخصة تداخلًا. راجع ما تطابق وسبب تطابقه قبل اتخاذ إجراء.
مراجعة الواجب
اعرض نتيجة فحص الانتحال في الشاشة نفسها التي تعرض المهمة وتفاصيل المراجع ومعايير التقييم وملاحظات المعلم.
استقبال المواد التحريرية
افحص الأعمال الواردة قبل النشر، وأرسل حالات التداخل الملحوظة إلى محرر لمراجعة المصدر.
محتوى الكتالوج
راجع أوصاف المنتجات أو الأسواق المتكررة قبل إضافتها إلى كتالوج كبير.
فحوص الجودة الداخلية
مرّر النص المصرح به عبر واجهة خلفية خاصة، وأبقِ المفتاح منفصلًا عن واجهة المتصفح.
الأسئلة الشائعة عن API
إجابات عملية قبل الإطلاق
ابدأ بطلب من الخادم، وسجّل بنية الاستجابة، ثم أضف النتيجة إلى مسار المراجعة الحالي لديك.
ما نقطة النهاية التي تستخدمها واجهة API لمدقق الانتحال؟+
أرسل طلب POST إلى https://api.detecting-ai.com/api/plagiarism/. يتضمن نص JSON حقل text المطلوب. أرسل X-API-Key واحفظ Idempotency-Key ثابتًا حتى تتمكن من إعادة المحاولة بأمان.
ماذا تحتوي الاستجابة الناجحة؟+
يحتوي الرد على نتيجة الانتحال وwords_processed. افحص النتيجة في بيئة اختبار قبل تعيينها إلى واجهة التقرير الخاصة بك.
هل يعني التطابق وجود انتحال بالضرورة؟+
لا. فقد تكون الصياغة المتطابقة اقتباسًا أو مادة مرخصة أو عبارة شائعة أو موثقة بمصدر صحيح أو جزءًا من قائمة مراجع. ينبغي أن يتيح مسار عملك للمراجع فحص المصدر والسياق.
هل ينبغي إرسال مفتاح API من المتصفح؟+
لا. احتفظ بالمفتاح في بيئة خادم موثوقة واتصل بنقطة نهاية الانتحال من هناك. لا يمكن لحزمة المتصفح أو المستودع العام حماية المفتاح الخاص.
كيف يتم حساب استخدام الانتحال؟+
يعتمد الاستخدام على عدد الكلمات المدخلة ويأتي من رصيد الانتحال في اشتراك API. تتضمن الاستجابات الناجحة words_processed.
أنشئ طلبك الأول
اختبر API بعينات موثقة وأخرى بلا توثيق
يتضمن الاختبار المفيد نصًا أصليًا وعبارات شائعة واقتباسات ومقطعًا معروفًا بأنه منسوخ، كي يستطيع فريقك تصميم حالات المراجعة المناسبة.