REST API / كشف الذكاء الاصطناعي

واجهة API لكاشف الذكاء الاصطناعي للإشارات الجاهزة للمراجعة

أرسل نصًا إلى نقطة نهاية HTTPS واحدة وأضف تحليل الكتابة بالذكاء الاصطناعي إلى منتجك. يعيد Detector v3 بيانات منظمة يستطيع فريقك فحصها وتخزينها وشرحها ضمن سياقها.

أنشئ مفتاح API قراءة الوثائق

استخدم المفتاح من بيئة خادم خاص.

طلب cURL

curl --request POST \
  --url https://api.detecting-ai.com/api/detect/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: detector-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to analyze.",
    "version": "v3"
  }'

طلبات POST إلى /api/detect/

المصادقة عبر X-API-Key

مفتاح Idempotency-Key يحدده العميل لإعادة المحاولات بأمان

Detector v3 للتكاملات الجديدة

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

مصمم لتدفقات المراجعة الحقيقية

بنية API بسيطة تترك مساحة للحكم المتأني

يظل التكامل بسيطًا: يرسل الخادم الخاص بك النص، ويقوم الكاشف بتحليله، وتقرر الواجهة كيفية تقديم النتيجة. هذا الفصل يجعل اختبار سير العمل أسهل ويحتفظ بالقرار النهائي للشخص.

نقطة نهاية واحدة مركزة

أضف النص وإصدار الكاشف إلى طلب JSON. لا تحتاج في التكامل الأساسي إلى SDK يتطلب منك متابعة تحديثاته.

الإخراج المنظم

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

تظل المراجعة البشرية واضحة

استخدم الإشارة لتحديد أولويات المقاطع والحالات. لا تحول نتيجة نموذج واحد إلى اتهام أو رفض تلقائي.

بنية الطلب

حقلان يكفيان للبدء

أرسل نص UTF-8 كـ JSON واختر إصدار الكاشف عمدًا. يجب أن تستخدم عمليات التكامل الجديدة v3.

حقل	النوع	مطلوب	ماذا يفعل
text	string	نعم	النص الذي تريد من الكاشف تحليله.
version	string	نعم	نسخة الكاشف. استخدم v3 للتكامل الجديد.

احتفظ بالاستجابة الكاملة أثناء التطوير

ابدأ بتسجيل استجابة JSON كاملة في بيئة اختبار آمنة. وبعد فهم العقد، اربط الحقول التي يستخدمها منتجك فقط، واحتفظ بعدد الكلمات المعالجة في سجلات الاستخدام.

مثال للرد

{
  "success": true,
  "data": {
    "details": {
      "result": "Detector analysis is returned here"
    },
    "version": "v3",
    "words_processed": 8
  }
}

مسار التكامل

من مفتاح API إلى نتيجة مفيدة

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

1
تحضير المفتاح وحفظه وتنشيطه
جهّز مفتاحًا في لوحة المعلومات، وانسخ قيمته التي تظهر مرة واحدة إلى مدير أسرار على الخادم، وأكّد حفظه ثم فعّله. لن تظهر القيمة الكاملة مجددًا بعد التفعيل.
2
أرسل عينة تمثيلية
أرسل عبر POST نصًا واقعيًا بالإصدار v3، واحفظ Idempotency-Key فريدًا قبل الإرسال. لا تعد استخدامه إلا للمحاولة نفسها بالضبط.
3
قدم الأدلة بعناية
ترجم الاستجابة المنظمة إلى حالة مراجعة واضحة، مع ترك مساحة للشخص لتفحص النص والسياق.

حالات مناسبة

مفيد عندما يمر النص بالفعل عبر قائمة انتظار المراجعة

يعمل API بشكل أفضل كمدخل واحد لعملية اتخاذ القرار الحالية. وينبغي أن يساعد الناس على تحديد المكان الذي يبحثون فيه، وليس اتخاذ القرار لهم.

الكشف ليس دليلًا على التأليف

قد تخطئ النماذج، ولا سيما مع النصوص القصيرة أو شديدة التحرير أو المترجمة أو النمطية. أبقِ القرارات ذات العواقب خارج مسارات العمل المؤتمتة بالكامل.

استقبال المواد التحريرية

أضف إشارة عن التأليف إلى المسودات المقدمة، ووجّه الحالات غير المعتادة إلى محرر لمراجعتها بدقة.

منصات التعليم

أعد إشارة للمراجعة بجانب سياق الواجب وسجل التعديلات والمراجع وسياسة المؤسسة.

الإشراف الداخلي

تحقق من النص المقدم داخل سير عمل خاص دون إرسال مفتاح API إلى المتصفح.

فرز الدُفعات

عالج المستندات المنتظرة على الخادم، وأظهر الحالات التي تستحق مراجعة بشرية ثانية.

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

إجابات عملية قبل الإطلاق

ابدأ بطلب من الخادم، وسجّل بنية الاستجابة، ثم أضف النتيجة إلى مسار المراجعة الحالي لديك.

ما هي نقطة النهاية التي يستخدمها كاشف الذكاء الاصطناعي API؟+

أرسل طلب POST إلى https://api.detecting-ai.com/api/detect/. يكون نص الطلب بصيغة JSON، وتستخدم المصادقة X-API-Key. وعلى التكاملات الجديدة حفظ Idempotency-Key ثابت لكل عملية منطقية.

ما هو إصدار الكاشف الذي يجب أن يستخدمه التكامل الجديد؟+

استخدم v3 لعمليات التكامل الجديدة. يُرسل الإصدار في نص طلب JSON ليكون السلوك محددًا وسهل الاختبار.

هل يمكنني الاتصال بـ API مباشرة من متصفح JavaScript؟+

لا تكشف مفتاح API خاصًا في شفرة المتصفح. أرسل الطلبات من خادمك أو من Edge Function أو من بيئة موثوقة أخرى، ولا تُعد إلى الواجهة إلا النتيجة التي تحتاجها.

هل تثبت نتيجة الذكاء الاصطناعي من كتب النص؟+

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

أين يمكنني التحقق من استخدام API والكلمات المتبقية؟+

تعرض لوحة تحكم API الرصيد المرتبط باشتراكك. ويذكر كل طلب ناجح للكاشف عدد كلمات الإدخال التي عولجت.

أنشئ طلبك الأول

أرسل طلب اختبار واحدًا قبل تصميم مسار العمل

استخدم الكاشف v3، واحتفظ بالمفتاح على الخادم الخاص بك، وافحص استجابة JSON الكاملة بنص يشبه إدخالك الحقيقي.

فتح وثائق API قارن الأسعار