تخطَّ إلى المحتوى
TurnitPass
المطوّرونAPI v1
الحصول على مفتاح API
تصفح التوثيق

المطوّرونمرجع API

TurnitPass REST API

مرجع نقاط النهاية المصادق عليها للأنسنة، وإعادة الصياغة، والكشف، والاستشهاد، والمراجع، وحالة مفاتيح API.

REST API v1

وحدة المرجع

ابدأ بالمسار والحمولة وشكل الاستجابة.

يغطي المرجع الكامل كل نقاط النهاية أدناه. تعرض الوحدة العقد الذي يحتاجه المطوّرون أولًا: مصادقة Bearer وإدخال JSON وناتج مقيس وفحوصات status.

request
POST
fetch('/api/v1/humanize', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tp_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'Paste the draft here',
    language: 'en',
    mode: 'reduce-aigc'
  })
})
response
200 OK
{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858,
  "status": "succeeded"
}
مقيسمسجّلJSON
POST/api/v1/humanize
POST/api/v1/paraphrase
POST/api/v1/rewrite
POST/api/v1/detect
POST/api/v1/citation
المصادقةBearer API key
التحويلPOST /humanize
المراجعةPOST /detect
الحالةGET /status
POST/api/v1/humanize
v1

تحسين النص المرسل وتقليل الإشارات الشبيهة بكتابة الذكاء الاصطناعي. الأوضاع المتاحة: reduce-aigc، reduce-both، paraphrase، academic-polish.

POST/api/v1/paraphrase
v1

إعادة كتابة النص وتحسينه باستخدام الأوضاع: القياسي، والطلاقة، والرسمي، والأكاديمي، والمبسط، والإبداعي، والتوسيع، أو الاختصار.

POST/api/v1/rewrite
v1

مخصص للتحرير الأكاديمي لإنتاج هيكلية أوضح، وتناغم صوتي، وانسيابية سلسة للجمل.

POST/api/v1/detect
v1

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

POST/api/v1/citation
v1

تنسيق DOI أو URL أو الاستشهاد اليدوي بأنماط: APA أو MLA أو Chicago أو IEEE أو Harvard أو Nature أو Vancouver أو ACS أو AMA أو GB/T أو OSCOLA أو Bluebook. تحتوي الاستجابات على HTML ونص عادي وBibTeX وRIS.

POST/api/v1/bibliography
v1

ترتيب وتنسيق قائمة المراجع بالنمط المطلوب، مع مخرجات بصيغ HTML/Text وتصدير بصيغ BibTeX وRIS.

GET/api/v1/status
v1

التحقق من تسمية المفتاح ورصيد الكلمات المتبقي وحدود الطلبات.

المعاملات والخيارات

المصادقة
Authorization: Bearer tp_your_api_key
حفظ المصطلحات
تتيح مصفوفة personal_terms الاختيارية الاحتفاظ بالأسماء والمصطلحات الفنية وأسماء العلامات التجارية أثناء معالجة النص الإنجليزي.
الحدود
Humanize/rewrite: 500 quality units; paraphrase: 2,000 quality units. Detection: 5,000 word units and 30,000 characters, with a separate daily scan allowance. Citations are rate-limited and do not spend writing credits.
الأخطاء
تحتوي استجابات JSON على حقول الخطأ (error) والكود (code) والرسالة (message).

حدود المعدل وحدود الطلب

إدخال التحويل
humanize/rewrite: 500; paraphrase: 2,000Quality units = CJK characters + other characters / 3, rounded up. Same limits on every plan.
إدخال الكشف
حتى 5,000 كلمةيجب تجزئة عمليات مسح detector الأطول قبل الإرسال.
مفاتيح API
حتى 5 مفاتيح نشطةيمكن إلغاء المفاتيح بشكل مستقل من مساحة العمل.
أدوات الاستشهاد
حد معدل منفصللا تستهلك استدعاءات citation وbibliography أرصدة الكلمات.

معالجة الأخطاء

تستخدم استجابات الخطأ JSON مع الحقول error وcode وmessage المقروء كلما أمكن.

error response
JSON
{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}
تبقى بيانات Stripe وGoogle إعدادًا. أُنجزت أسطح API وتدفق المصادقة والتخزين حتى تُضاف بيانات الاعتماد المباشرة دون إعادة تصميم المنتج.

أمثلة

مثال humanize
JSON
POST /api/v1/humanize
{
  "text": "الصق المسودة المدعومة بالذكاء الاصطناعي التي تريد تحسينها",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["اسم خاص"]
}

200 OK
{
  "output": "النص البشري المعدل...",
  "words_used": 142,
  "words_remaining": 2858
}
مثال متعدد نقاط النهاية
JSON
POST /api/v1/paraphrase
{
  "text": "الصق المسودة التي تريد إعادة صياغتها",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "الصق المسودة التي تريد فحصها",
  "language": "en",
  "source_kind": "paste"
}

POST /api/v1/citation
{
  "input": "https://example.com/article",
  "style": "apa"
}

200 OK
{
  "text": "الاستشهاد المنسق...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

الخطوات التالية

البدء السريع

جهّز الطلب الأول.

المصادقة

راجع التعامل مع مفاتيح API.

سجل التغييرات

اطلع على تغييرات المنصة الأخيرة.

بعد ذلك، اربطه بسير عملك.متابعة القراءة