توثيق API
كل ما تحتاجه لدمج الإشراف على المحتوى من Discuse في تطبيقك. API بسيطة بأسلوب REST، وميزات شاملة، ودقة رائدة في المجال.
ابدأ الآن
دليل بدء سريع لدمج Discuse API في تطبيقك.
تحليل النصوص
حلّل المحتوى النصي لرصد spam، والسمّية، والمشاعر، واللغة.
تحليل الصور
اكتشف محتوى NSFW والصور غير الملائمة بدقة عالية.
معالجة المستندات
استخرج النصوص من الصور وPDFs باستخدام OCR، ثم أشرف عليها أو لخّصها.
نقاط نهاية API
نظرة سريعة على نقاط نهاية API المتاحة. تقبل جميع نقاط النهاية JSON وتُرجع استجابات JSON.
/api/v2/checkفحص كامل للإشراف على المحتوى بكل الميزات المفعّلة.
/api/v2/demo/checkنقطة نهاية تجريبية عامة (بحدود معدّل استخدام، ولا تتطلب مفتاح API).
/api/v2/scanفحص الملفات بحثًا عن البرمجيات الخبيثة والفيروسات.
/api/v2/ocrاستخراج النصوص من الصور وPDFs، مع خيار الإشراف عليها.
/api/v2/summarizeإنشاء ملخص موجز للمستند.
/api/v2/demo/ocrعرض OCR تجريبي عام (بحدود معدّل استخدام، ومن دون مفتاح API؛ PDFs حتى 20 صفحة).
/api/v2/demo/summarizeعرض تجريبي عام للتلخيص (بحدود معدّل استخدام، ومن دون مفتاح API؛ PDFs حتى 20 صفحة).
URL الأساسي
يجب إرسال جميع طلبات API إلى URL الأساسي التالي:
https://api.discuse.comالمصادقة
صادِق طلبات API الخاصة بك عبر تضمين مفتاح API في ترويسة الطلب.
X-API-Key: your_api_key_hereليس لديك مفتاح API؟ ابدأ من هنا لإنشاء مفتاح.
تنسيق الاستجابة
تتبع جميع استجابات API بنية JSON موحّدة:
{
"has_violations": false,
"cached": false,
"message": "Content appears safe",
"results": {
"hits": false,
"sentiment": {
"hit": false,
"toxic": 0.02,
"profanity": 0.01,
"threat": 0.00,
"insult": 0.03
},
"spam_finder": {
"is_spam": false,
"confidence": 0.05
},
"language": {
"detected": "en",
"confidence": 0.98
}
},
"processing_time_ms": 45,
"usage": {
"api_requests_used": 150,
"api_requests_limit": 10000,
"api_requests_remaining": 9850
}
}