توثيق واجهة API

POST/api/v1/run

ينفّذ مهمة ذكاء اصطناعي واحدة على نص ويعيد النتيجة نصًا عاديًا (بلا مقدمة وبلا أسوار شيفرة Markdown).

الطلب

POST /api/v1/run HTTP/1.1
Content-Type: application/json

{
  "task": "paraphrase",
  "mode": "Formal",
  "lang": "ar",
  "text": "الكتابة الجيدة مهمة جدًا للطلاب.",
  "options": {}
}

الاستجابة

الحالة 200 مع ok: true والنتيجة في output، والنموذج الذي أجاب فعلًا في model (ويختلف حين يتدخل نموذج احتياطي)، وزمن المعالجة بالمللي ثانية. وتُضاف truncated: true حين بلغت الإجابة حدّ طولها أو مهلتها فقُطعت.

{
  "ok": true,
  "output": "تُعدّ جودة الكتابة أمرًا أساسيًا للطلاب.",
  "model": "@cf/qwen/qwen3-30b-a3b-fp8",
  "ms": 812
}

مثال: curl

curl -X POST https://adeptwrite.com/api/v1/run \
  -H "Content-Type: application/json" \
  -d '{"task":"grammar","lang":"ar","text":"ذهب الطلاب الى المدرسه صباحا."}'

مثال: JavaScript (fetch)

const res = await fetch('/api/v1/run', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ task: 'summarize', mode: 'Poin-poin', lang: 'ar', text }),
});
const data = await res.json();
if (!data.ok) throw new Error(data.error.code + ': ' + data.error.message);
console.log(data.output);

POST/api/v1/plagiarism

يختار من ٤ إلى ٨ عبارات مميزة من النص، ويبحث عنها في مصادر مفتوحة بلغة النص (ويكيبيديا وويكي مصدر والنص الكامل في أرشيف الإنترنت وEurope PMC وDOAJ وarXiv؛ ومزوّد بحث ويب فقط إذا كان مهيّأً ومطلوبًا)، ثم يقيس درجة التداخل. لا يغادر الخادمَ إلا تلك العبارات القصيرة.

الطلب

POST /api/v1/plagiarism HTTP/1.1
Content-Type: application/json

{ "text": "…٣٠ كلمة على الأقل…", "lang": "ar", "options": { "web": false } }

الاستجابة

الحالة 200 مع score (الكلمات المتطابقة ÷ الكلمات، من ٠ إلى ١)، وmatches لكل مصدر مع مقاطع passages مظلّلة (مواضع الأحرف في نصك)، وsourcesSearched (المصادر التي دخلت إجاباتها في النتيجة بالضبط)، وsourcesSkipped مع السبب، وwebSearched.

{
  "ok": true,
  "score": 0.42,
  "words": 52,
  "matchedWords": 22,
  "matches": [{ "source": "wikipedia", "title": "…", "url": "https://ar.wikipedia.org/wiki/…",
                "matchedWords": 22, "passages": [{ "start": 0, "end": 131, "text": "…" }] }],
  "sourcesSearched": ["wikipedia", "wikisource", "internet-archive-fts", "europepmc", "doaj"],
  "sourcesSkipped": [],
  "webSearched": false,
  "ms": 2310
}

مثال: curl

curl -X POST https://adeptwrite.com/api/v1/plagiarism \
  -H "Content-Type: application/json" \
  -d '{"lang":"ar","text":"…٣٠ كلمة على الأقل…"}'

GET/api/v1/health

يبيّن الخدمات المفعّلة. لا يأخذ جسمًا (body) ولا يُحتسب من الحصة.

الاستجابة

الحالة 200. يكون ai بقيمة false طالما مفتاح إيقاف الذكاء الاصطناعي مفعّلًا؛ ويسرد plagiarism المصادر التي يستطيع الفاحص الاستعلام منها؛ ويصف aidetect التحليل المعمّق على الخادم لكاشف الذكاء الاصطناعي، وهو غير منشور بعد (تجيب POST /api/v1/aidetect بـ 503 disabled؛ أما الكاشف في الموقع فيعمل داخل متصفحك).

{
  "ok": true,
  "ai": true,
  "plagiarism": { "enabled": true, "sources": ["wikipedia", "wikisource", "internet-archive-fts", "europepmc", "doaj", "arxiv"], "web": false },
  "aidetect": { "enabled": false, "judge": false }
}

مثال: curl

curl https://adeptwrite.com/api/v1/health

Task list