واجهة برمجة تطبيقات البحث عن الانتحال: أسئلة وأجوبة
API (واجهة برمجة التطبيقات) عبارة عن مجموعة من الإجراءات والبروتوكولات والأدوات اللازمة لإنشاء تطبيقات البرامج. تم إنشاؤه لمساعدة المؤسسات على التحقق من كميات كبيرة من النص من خلال أنظمتها. تمنح واجهة برمجة التطبيقات (API) الخاصة بنا للعملاء فرصة فريدة لدمج برامجنا في أنظمتهم الخاصة لجعل عملية التحقق من الانتحال عملية آلية. نظرًا لأن تكامل واجهة برمجة التطبيقات (API) يتطلب معرفة محددة وعادةً ما يتم استكماله بواسطة متخصصين تقنيين، تنشأ العديد من الأسئلة حول ميزاته الخاصة لضمان التشغيل الفعال. قمنا في المقالة بجمع الأسئلة والإجابات الأكثر شيوعًا حول أداء واجهة برمجة التطبيقات (API) لدينا، وحلول المشكلات الأكثر شيوعًا التي يواجهها عملاؤنا أثناء عملية التكامل.
بالإضافة إلى ذلك، يمنح تكامل واجهة برمجة التطبيقات (API) لعملائنا فرصة الاستفادة من مساحة التخزين الشخصية. يمكن للعملاء تحميل الأرشيفات الخاصة بهم إلى نظام التخزين وحفظ النصوص التي تم التحقق من عدم وجود سرقة أدبية من خلال واجهة برمجة التطبيقات الخاصة بنا، وبالتالي إنشاء مساحة تخزين فردية. يتيح التحقق من النصوص بحثًا عن الانتحال على وحدة التخزين الشخصية لعملائنا اكتشاف ومنع الانتحال الذاتي. اقرأ المزيد حول وظائف التخزين الشخصي في دليلنا https://plagiarismsearch.com/plagiarism-database.
ما الميزات المتوفرة من خلال واجهة برمجة التطبيقات (API)؟
- التحقق من النصوص والمستندات بحثًا عن الانتحال
- الوصول إلى تقارير الانتحال (تاريخ عمليات فحص الانتحال)
- القدرة على تحميل قاعدة بيانات العميل إلى وحدة التخزين وعرض المستندات الموجودة في وحدة التخزين
- يتمتع الموردون بفرصة إنشاء حسابات مستخدمين متعددة وتخصيص عدد مناسب لهم من المشاركات/الكلمات. ستتيح هذه الخيارات لكل إحالة إمكانية استخدام حسابه بشكل مستقل.
كيف يمكنني الوصول إلى واجهة برمجة التطبيقات (API)؟
يمكنك الوصول إلى واجهة برمجة التطبيقات الخاصة بنا مجانًا لمدة 30 يومًا. سيكون لديك أيضًا 100 إرسال وتخزين شخصي لاختبار جميع مزايا خدمتنا. يرجى التسجيل باستخدام هذا الرابط للحصول على إمكانية الوصول إلى واجهة برمجة التطبيقات المجانية: https://plagiarismsearch.com/account/signup?from =%2Faccount%2Fapi
بعد التسجيل، انتقل إلى ملفي الشخصي - إعدادات واجهة برمجة التطبيقات (API)، وسترى مستخدم واجهة برمجة التطبيقات (API) والمفتاح المقدمين شخصيًا لاستخدامك. ستحتاج أيضًا إلى استخدام وثائق واجهة برمجة التطبيقات (API) الخاصة بنا (انقر فوق قسم وثائق واجهة برمجة التطبيقات (API) https://plagiarismsearch.com/docs/ في ملفك الشخصي لمشاهدته). قم بتوفير الوصول إلى المعلومات المذكورة أعلاه للمتخصص الفني الخاص بك لبدء استخدام واجهة برمجة التطبيقات (API) الخاصة بنا.
كيف تعمل واجهة برمجة التطبيقات الخاصة بفحص الانتحال؟
مخطط عملية واجهة برمجة التطبيقات لدينا هو كما يلي:
- يقوم المستخدم بإنشاء تقرير (عن طريق إرسال نص أو تحميل ملف أو عنوان URL عام) https://plagiarismsearch .com/docs/v3/reports/create
- إذا كان رصيدك نشطًا - فستتم إضافة مستندك للتحقق منه
- إذا قمت بفحص 1000-3000 كلمة مرة واحدة، فقد يستغرق ذلك من 30 إلى 60 ثانية؛ المزيد من الكلمات تستغرق وقتًا أطول قليلًا
- بعد التحقق من المستند، يحصل المستخدم على `callback_url` طلب POST https://plagiarismsearch.com/docs /v3/reports/callback-request
- نموذج لاستخدام واجهة برمجة التطبيقات في PHP https://plagiarismsearch.com/files/sample-api.zip
هل تضمن واجهة برمجة التطبيقات التحقق التلقائي من النص في الوقت الفعلي؟
هل يمكن إعداد وتحميل التقارير من خلال واجهة برمجة التطبيقات؟
نعم، يمكنك تنزيل تقرير PDF أو HTML مباشرة بعد اكتمال التحقق من السرقة الأدبية. يتم تخزين كافة التقارير في قاعدة بياناتنا، بحيث يمكنك الوصول إليها في أي وقت وتنزيلها https://plagiarismsearch.com/docs/ v3/تقارير/عرض
هل من الممكن إنشاء قالب التقرير الخاص بي؟
لا. لدينا 2 قوالب التقارير المتاحة. يمكنك فقط إدراج شعار شركتك في قالب التقرير الخاص بنا.
هل تعمل واجهة برمجة التطبيقات (API) على تمكين أجزاء معينة من التحقق من النص؟
نعم، إذا كنت تتحدث عن تضمين أو استبعاد المراجع أو الاستشهادات، وإدراج عناوين URL معينة في القائمة البيضاء.
هل من الممكن عرض سجل التحقق من النص من خلال واجهة برمجة التطبيقات؟
نعم، يتم حفظ كافة التقارير في قاعدة بياناتك.
هل هي REST API أم مكون إضافي؟ هل هو متزامن أم غير متزامن؟
نحن نقدم RESTful API. يمكنك الوصول إلى وثائق واجهة برمجة التطبيقات الخاصة بنا هنا: https://plagiarismsearch.com/docs/
واجهة برمجة التطبيقات لدينا غير متزامنة. عند الانتهاء من التحقق من الانتحال، نرسل web_hook إلى المستخدم callback_url (https://plagiarismsearch.com/docs/v3 /reports/callback-request).
هل هناك أية تعليمات حول كيفية تنفيذ واجهة برمجة التطبيقات (API)؟
المخطط الأكثر تفصيلاً لتطبيق واجهة برمجة التطبيقات (API) هو كما يلي:
- سجل في موقعنا هنا https://plagiarismsearch.com/account/signup
- تأكد من رصيدك نشط أو قم بالتسجيل للحصول على نسخة تجريبية مجانية من واجهة برمجة التطبيقات https://plagiarismsearch.com/account/signup?from=%2Faccount %2فابي
- انتقل إلى ملفي الشخصي - إعدادات واجهة برمجة التطبيقات، وسترى يتم توفير مستخدم واجهة برمجة التطبيقات والمفتاح شخصيًا لاستخدامك https://plagiarismsearch.com/account/api
- أرسل ملفًا أو نصًا لـ
التحقق من الانتحال باستخدام مصادقة HTTP الأساسية https://plagiarismsearch.com/docs/v3/reports/create.
فيما يلي مثال في CURL:
curl_setopt($curl, CURLOPT_USERPWD, $apiUser . ':' . $apiKey);
- سوف تتلقى ردًا مع معرف التقرير: <ديف> <الرمز>"البيانات": { "المعرف": 100500، "auth_key": "65jdgjhh7h452hjkh45k7535", ... }
- يبدأ محرك الكشف الخاص بنا عملية التحقق من الانتحال.
- بعد التحقق من السرقة الأدبية عند اكتماله، يرسل النظام POST web_hook إلى عنوان URL المرتبط بـ الوثيقة المقدمة. في حالة عدم الإشارة إلى عنوان URL، يرسل النظام POST web_hook إلى عنوان URL المرتبط بحساب المستخدم.
- هناك طريقة بديلة للضبط
ومع ذلك، فإن حالة فحص الانتحال لا ينصح بها فريقنا. هو لرصد
حالة التقرير https://plagiarismsearch.com/docs/v3/reports/status
خلال فترات زمنية معينة، والتحقق مما إذا كانت حالة التقرير
"انتهى" (
الحالة=2
)، أو "خطأ" (الحالة=-10
)، أو "خطأ في الخادم" (الحالة=-11
) - عندما تتم عملية الانتحال بعد اكتمال الفحص، قد تحصل على معلومات تفصيلية باستخدام معرف التقرير. يمكن العثور على أحد الأمثلة هنا: https://plagiarismsearch.com/docs/v3/reports/view
يمكنك أيضًا تحديد المعلمة `show_relations` للحصول على المزيد من البيانات.
على سبيل المثال
<الرمز>
const RELATIONS_SOURCES = -2;
const RELATIONS_RAW = -1;
const RELATIONS_NONE = 0؛ // الافتراضي
const RELATIONS_TREE = 1;
show_relations = -2 =>
يعرض قائمة المصادر مرتبة حسب نسبة الانتحال. راجع حقل الاستجابة`data.sources`
show_relations = -1 =>
يُرجع كافة بيانات التقرير. الفقرات والجمل والمصادر مع تمييز النص. راجع حقل الاستجابة`data.paragraphs`
show_relations = 1 =>
يُرجع كافة بيانات التقرير. الفقرات والجمل والمصادر مع تمييز النص. راجع حقل الاستجابة`data.paragraphs`
هل تحتاج النصوص البرمجية إلى انتظار نتيجة اختبار الانتحال أم أن هناك وظيفة رد اتصال يمكن استدعاؤها في وقت لاحق للحصول على نتيجة معالجة المستند؟
يوجد رابط رد اتصال لطلب عنوان URL POST نقوم بتوصيله بالمستخدم. يمكنك أيضًا الإشارة إلى callback_url (المخصص) الخاص بك في الإعدادات عند إرسال المستند ( https://plagiarismsearch.com/docs/v3/reports/create، https://plagiarismsearch.com/docs/v3/reports/callback-request)
يمكن تنزيل التقرير بعدة تنسيقات: (https://plagiarismsearch.com/docs/v3/reports/view ) (راجع "الرد")
<ما قبل><الكود>{ "الحالة": صحيح، "الكود": 200، "بيانات": { "file": "https://plagiarismsearch.com/reports/download/100500?key=54fba6bc7d765cab653f2185a83284a6"، // عنوان URL العام لتقرير pdf "link": "https://plagiarismsearch.com/reports/100500?key=54fba6bc7d765cab653f2185a83284a6"، // عنوان URL لتقرير HTML العام "الملفات": [ { // إصدار URL لتقرير pdf باللغة الإنجليزية العامة 3 "url": "https://plagiarismsearch.com/r/download100500?key=54fba6bc7d765cab653f2185a83284a6", "النوع": "التطبيق/pdf"، "اللغة": "ar"، "الإصدار": 3 }, { // إصدار عنوان URL لتقرير ES pdf العام 3 "url": "https://plagiarismsearch.com/es/r/download/100500?key=54fba6bc7d765cab653f2185a83284a6", "النوع": "التطبيق/pdf"، "اللغة": "es"، "الإصدار": 3 }, { // إصدار عنوان URL لتقرير PL pdf العام 3 "url": "https://plagiarismsearch.com/pl/r/download/100500?key=54fba6bc7d765cab653f2185a83284a6", "النوع": "التطبيق/pdf"، "اللغة": "رر"، "الإصدار": 3 }, {// إصدار URL لتقرير PDF العام باللغة الإنجليزية الإصدار 1 (الحالي) "url": "https://plagiarismsearch.com/reports/download/100500?key=54fba6bc7d765cab653f2185a83284a6", "النوع": "التطبيق/pdf"، "اللغة": "ar"، "الإصدار": 1 } ] }
كيف يمكنني الحصول على تقرير HTML؟
للحصول على رابط تقرير HTML، عليك إرساله طلب الحصول على https://plagiarismsearch.com/api/v3/reports/{id} حيث {id} هو معرف التقرير الذي تريد تلقي تقرير عنه. في "الرد" البيانات ستجد رابط التقرير في حقل "رابط البيانات". وأيضا في "الرد" ستجد "data.auth_key" الذي يمكنك من خلاله إنشاء 3 متغيرات محتملة من تقارير HTML.
على سبيل المثال، هناك 3 خيارات محتملة من تقارير HTML لـ data.auth_key=65jdgjhh7h452hjkh45k7535
- https://plagiarismsearch.com/reports/100500?key=65jdgjhh7h452hjkh45k7535
- https://plagiarismsearch.com/r/100500?key=65jdgjhh7h452hjkh45k7535
- https://plagiarismsearch.com/reports/lite/100500?key=65jdgjhh7h452hjkh45k7535
بالإضافة إلى ذلك، يمكنك إنشاء روابط التقارير بأربع لغات مختلفة (EN، ES، PL، RU)
- https://plagiarismsearch.com/reports/100500?key=65jdgjhh7h452hjkh45k7535
- https://plagiarismsearch.com/es/reports/100500?key=65jdgjhh7h452hjkh45k7535
- https://plagiarismsearch.com/pl/reports/100500?key=65jdgjhh7h452hjkh45k7535
- https://plagiarismsearch.com/ru/reports/100500?key=65jdgjhh7h452hjkh45k7535
لك الحرية في الجمع بين المتغيرات المختلفة من تقارير HTML واللغات لتلقي تقرير النوع الضروري عن الموقع المختار لغة.
يمكن استخدام مخطط مماثل لإنشاء تقرير PDF الرابط (يمكن الاطلاع على عناوين URL هذه في "الاستجابة" -> "ملفات البيانات").
على سبيل المثال:
<السابق><الكود>... "الملفات":[ { "url":https://plagiarismsearch.com/r/download/100500?key=65jdgjhh7h452hjkh45k7535"، "نوع": "التطبيق/قوات الدفاع الشعبي"، "اللغة":"ar"، "الإصدار":3 }, { "url":https://plagiarismsearch.com/es/r/download/100500?key=65jdgjhh7h452hjkh45k7535"، "نوع": "التطبيق/قوات الدفاع الشعبي"، "اللغة:"es"، "الإصدار":3 } ] ...
لا أستطيع العثور على نقاط النهاية/التفاصيل حول كيفية إنشاء رموز الوصول المميزة.
سيكون الرمز المميز في حسابك بعد التسجيل (https://plagiarismsearch.com/account/api)
من الضروري إرسالها باستخدام مصادقة HTTP الأساسية.
php باستخدام CURL
<الرمز>
// مصادقة HTTP الأساسية
curl_setopt($curl, CURLOPT_USERPWD, $apiUser . ':' . $apiKey);
أرغب في إرفاق الملفات بصيغة DOCX وPDF وPPT للتحقق منها. هل من الممكن؟
يمكنك إرفاق ملفات بتنسيقات متعددة: (https://plagiarismsearch.com/docs/v3/reports/create< /a>) سلسلة الملف أو تحميل ملف للتحقق.
إلى جانب ذلك، يمكنك إرسال ملفات بالاسم `file`
كيف يمكنني الحصول على قائمة عناوين URL التي تم العثور على النص فيها؟
كيف يمكنني استبعاد عنوان URL الخاص بي من هذه القائمة؟
أ) POST['url'] = 'https://wikipedia.org'
أو
ب) POST['source'] = {source.id} (على سبيل المثال data.sources[0].id (عدد صحيح))
أو
مصفوفة معرفات المصدر التي تم تخطيها
POST['sources'][] = {source.id}
POST['sources'][] = {source.id2}
إذا اتصلت بالمسار مرتين - فسيتم تضمين عناوين URL مرة أخرى، مما يؤثر على النسبة العامة للسرقة الفكرية
نخطط أيضًا لإكمال مجموعة الميزات التي تسمح باستثناء عنوان URL هنا: https://plagiarismsearch.com/api/ v3/reports/create
كيف يمكنني إعادة حساب نسبة الانتحال بعد الاستبعاد؟
سيتضمن الرد على الطلب النسبة العامة (المعدلة) للسرقة الفكرية data.plagiat
ما فائدة "filter_references" و"filter_quotes"؟
filter_references=1 =>
استبعاد المراجع. ليس لنص المراجع أي وزن في نسبة الانتحال الإجمالية
filter_quotes=1 =>
استبعاد الاقتباس في النص. نص الاقتباس ليس له وزن في نسبة الانتحال الإجمالية. علامات الاقتباس هي
<ص>
<الرمز>
المصفوفة('«', '»'),
المصفوفة('"', '"'),
المصفوفة('"', '"'),
المصفوفة('《', '》'),
المصفوفة('〈', '〉'),
المصفوفة('{*', '*}'),
هل هناك طريقة لتنفيذ واجهة برمجة التطبيقات عبر CURL؟
فيما يلي الإرشادات التي قد تسهل تنفيذ CURL.
- تحميل مستند للتحقق من الانتحال https://plagiarismsearch.com/docs/v3/reports/create
<الرمز> حليقة --الموقع --طلب POST 'https://plagiarismsearch.com/api/v3/reports/create' \
--header 'التفويض: الأساسي your_user_key_combination==' \
--form 'search_web="1"' \
--form 'search_storage="1"' \
--form 'file=@"test_file_plagiarism.txt"'
- عرض التقرير https://plagiarismsearch.com/docs/v3/reports/view
<الرمز> حليقة --الموقع --طلب الحصول على 'https://plagiarismsearch.com/api/v3/reports/3520470' \
--header 'التفويض: الأساسي your_user_key_combination=='
لماذا توجد حالة المستند "معلق" في وحدة التخزين؟
يظل المستند عادةً في حالة "معلق" لفترة ليست طويلة، من 0 إلى 6 دقائق بعد تحميله أو إعادة تحميله. تتم إضافة المستند فورًا إلى فهرس البحث.
يمكنك أيضًا التحقق من ذلك في كود البرنامج: إذا مرت 6 دقائق، تصبح الوثيقة في حالة نشطة.
من الممكن معرفة حالة المستند باستخدام هذه الطريقة:
احصل على https://plagiarismsearch.com/api/v3/storage/{id
راجع الحقل `data.is_in_index`
كيفية تحميل المستندات إلى وحدة التخزين عبر واجهة برمجة التطبيقات؟
يمكنك تحميل مستنداتك عبر واجهة برمجة التطبيقات:
انشر https://plagiarismsearch.com/api/v3/storage/create
مع المعلمات، التي تشبه https://plagiarismsearch.com/docs/v3/reports/create
بدلاً من ذلك، يمكنك تحميل المستندات في قائمة أو أرشيف باستخدام النموذج https://plagiarismsearch.com/storage/upload>
ما هي إمكانيات حساب الموزع؟ كيف يمكنني دمجه في نظامي الخاص؟
الوظائف التي يقدمها حساب الموزع الخاص بنا هي:
- يجب إنشاء كل مستخدم جديد من خلال واجهة برمجة التطبيقات (ستحتاج إلى تسجيل الدخول وكلمة المرور لإنشاء كل حساب مستخدم)
- ستتاح لك الفرصة لتخصيص عدد معين من الكلمات لكل مستخدم من خلال حساب المورد.
ستفعل هذه الخيارات إعطاء الإمكانية لكل عميل لاستخدام حسابه بشكل مستقل، و ستتمكن من إضافة الكلمات الضرورية لكل مستخدم
تقني الوثائق اللازمة للتكامل:
يجب أن يكون لديك حساب من نوع الموزع
لتكون قادرة على خلق العملاء. اتصل بنا علىservices@plagiarismsearch.com
to
الحصول على إمكانية الوصول إلى الإمكانيات الكاملة لحساب الموزع.
إنشاء عميل
لإنشاء عميل جديد، أرسل طلب POST https://plagiarismsearch.com/api/v3/reseller-customers/create (البريد الإلكتروني للعميل هو حقل مطلوب)
على سبيل المثال:
curl --location --طلب POST
"https://plagiarismsearch.com/api/v3/reseller-customers/create" \
--header "التفويض: أساسي
your_user_key_combination===' \
--form 'email="testusermail@gmail.com"' \
--form 'name="User Name"' \
--نموذج 'password="123456"'
الاستجابة
<ديف> <ما قبل><الكود>{ "الحالة": صحيح، "الكود": 200، "بيانات":{ "المعرف": 26784، "البريد الإلكتروني": "testusermail@gmail.com"، "الاسم": "اسم المستخدم"، "الحالة": "نشطة"، "كلمة المرور": "123456" }, "الإصدار": "3.0.0"
قائمة العملاء
أرسل طلب الحصول على "https://plagiarismsearch.com/api/v3/reseller-customers" لتلقي قائمة جميع العملاء الذين تم إنشاؤهم.
على سبيل المثال:
<الرمز>
حليقة --الموقع --طلب الحصول على
'https://plagiarismsearch.com/api/v3/reseller-customers' \ --header
'التفويض: your_user_key_combination الأساسي=='
إظهار الأرصدة
أرسل طلبًا للحصول على https://plagiarismsearch.com/api/v3/reseller-customers/balance لعرض رصيدك.
أرسل طلبًا للحصول على https://plagiarismsearch.com/api/v3/reseller- العملاء/الرصيد/{userId لمعرفة رصيد عميل معين.
مثال على استجابة الرصيد:
<ما قبل><الكود>{ "الحالة": صحيح، "الكود": 200، "بيانات":{ "غير قابل للحل": صحيح، "700":{ "نوع": "كلمات"، "المبلغ":6001, "انتهت الصلاحية":1878542044، "is_valid":صحيح، "is_solvable": صحيح }, "300":{ "نوع": "الإرسالات"، "المبلغ":4، "انتهت الصلاحية":1720878480, "is_valid":صحيح، "is_solvable": صحيح } }, "الإصدار": "3.0.0"
الدفع إلى رصيد العميل
أضف العدد اللازم من عمليات الإرسال أو الكلمات إلى حساب عميل معين عن طريق إدخال معرف المستخدم وإدخال المبلغ في حقل "الكلمات" أو "الإرسالات" (1 تقديمات = 1000 كلمة).
على سبيل المثال:
<الرمز>
حليقة - الموقع - طلب POST
'https://plagiarismsearch.com/api/v3/reseller-customers/pay/26784' \
--header "التفويض: الأساسي your_user_key_combination==' \
--form 'words="1000"'
<ما قبل><الكود>{
"الحالة": صحيح،
"الكود": 200،
"بيانات":{
"معرف_الدفع":1171,
"المبلغ":100،
"نوع": "كلمات"
},
"الإصدار": "3.0.0"
كيفية تصحيح الخطأ: 400 طلب سيئ عند إرسال نص للسرقة الأدبية؟
مثال الخطأ الذي قد تحصل عليه عندما قد يبدو إرسال نص للسرقة الأدبية كما يلي:
طريقة الطلب: PUT
رمز الحالة: 400 طلب سيئ
الاستجابة: لا توجد مثيلات متاحة لـ الانتحال.com
واجهة برمجة تطبيقات الانتحال المستخدمة: https://plagiarismsearch.com/api/v3 / التقارير / إنشاء
الحل:
يجب على العميل استخدام طريقة POST Http (وليس PUT) كما في لقطة الشاشة
يوجد خطأ في المصادقة أثناء تشغيل /التقرير على GET باستخدام وحدة الطلب في Python.
يجب عليك إرسال البيانات المتعلقة بالمصادقة عند كل طلب جديد.
نستخدم المصادقة الأساسية، مثل< https://docs.python-requests.org/ ar/master/user/authentication/
<الرمز>
من request.auth قم باستيراد HTTPBasicAuth
>>> request.get(' https://plagiarismsearch.com/api/v3/reports/{id}', auth=HTTPBasicAuth('apiUser', 'apiKey'))
// مصادقة HTTP الأساسية Php باستخدام CURL
curl_setopt($curl, CURLOPT_USERPWD, $apiUser . ':' . $apiKey);