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

المطوّرونوثائق المطورين

وثائق TurnitPass API

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

REST API v1

One request

Quick example

أرسل النص إلى نقطة نهاية humanizer بمفتاح API من نوع Bearer. تعيد الاستجابة الناتج المحوّل وعدد الكلمات المستخدمة والرصيد المتبقي لمالك المفتاح.

curl
POST /api/v1/humanize
curl -X POST https://turnitpass.com/api/v1/humanize \
  -H "Authorization: Bearer tp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Paste your draft here","language":"en","mode":"revise"}'
response
200 OK
{
  "output": "Your humanized text...",
  "words_used": 6,
  "words_remaining": 249994
}
يعرض TurnitPass أيضًا نقاط النهاية paraphrase وrewrite وdetector وcitation وbibliography وstatus ضمن تدفق مفتاح API نفسه.

Route map

Explore the docs

01

البدء السريع

قم بإنشاء مفتاح API من مساحة العمل، ثم استدعِ وظائف الكتابة، والفحص، والاستشهاد باستخدام المفتاح نفسه.

02

المصادقة

تستخدم طلبات التطوير مفاتيح API التي يتم إنشاؤها من لوحة تحكم TurnitPass.

03

مرجع API

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

04

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

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

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

أنشئ مفتاحًا وأرسل الطلب الأول.

TurnitPass REST API

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

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

Request lifecycle

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

1

مصادقة مفتاح API

أرسل مفتاحًا مُنشأً من مساحة العمل. تفشل المفاتيح الملغاة أو المشوّهة أو المفقودة قبل بدء معالجة النص.

2

التحقق من النص واللغة والحدود

تفرض طلبات التحويل نطاقات الكلمات، وتفرض طلبات detector حدود مسح أطول، وتتحقق طلبات citation من الأسلوب والمصدر.

3

تشغيل المسار

تعيد مسارات humanize وparaphrase وrewrite وdetect وcitation وbibliography استخدام السلوك نفسه من جهة الخادم كما في الأدوات العامة.

4

تسجيل الاستخدام وإعادة الناتج

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

واجهة API

نقاط النهاية الرئيسية

أنسنة النصوص

POST/api/v1/humanize

تقليل إشارات الكتابة الشبيهة بالذكاء الاصطناعي مع الحفاظ التام على المعنى.

إعادة الصياغة

POST/api/v1/paraphrase

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

الكشف

POST/api/v1/detect

إرجاع نتيجة الكشف ومستوى المخاطر وإشارات أنماط الكتابة.

الاستشهادات

POST/api/v1/citation

تنسيق المعرف الرقمي DOI أو عناوين URL أو البيانات الوصفية للمصادر اليدوية.

Production checklist

استدعاءات من الخادم
لا تعرض مفاتيح API أبدًا في حزمة العميلاستدعِ TurnitPass من الخلفية أو worker أو قائمة الانتظار أو server action المحمية.
سلوك إعادة المحاولة
أعد محاولة أعطال الشبكة لا أعطال التحققتعامل مع استجابات 4xx كمشكلات مستخدم أو حمولة، واحفظ إعادة المحاولة لأخطاء 5xx أو الشبكة العابرة.
ميزانية الكلمات
اعرض الرصيد قبل المسارات الثقيلةاستخدم نقطة نهاية status لتقرر وضع المهمة في قائمة الانتظار أو طلب ترقية أو تقسيم المستند.
الفوترة
أسرار Stripe هي الإعداد النهائيcheckout وportal وwebhook موصولة؛ تُترك المفاتيح المباشرة ومعرّفات الأسعار للنشر.
لدمج المنتج، احتفظ بمفتاح TurnitPass واحد لكل بيئة. يجب أن تكون بيئات الإنتاج والتجربة والتطوير المحلي قابلة للإلغاء بشكل مستقل.
بعد ذلك، اربطه بسير عملك.متابعة القراءة