تصفح التوثيق
المصادقة باستخدام مفاتيح API
تستخدم طلبات التطوير مفاتيح API التي يتم إنشاؤها من لوحة تحكم TurnitPass.
Auth console
أبقِ مفاتيح API خارج المتصفح.
تستخدم استدعاءات TurnitPass API مفتاح Bearer تابعًا لمساحة العمل. مكان المفتاح هو الشفرة المخصصة للخادم فقط، بينما تبقى لوحة التحكم المكان لإنشاء المفاتيح وتدويرها وإلغائها وفحص الاستخدام.
حواجز المفتاح
كيف تبقي الوصول آمنًا
الخادم فقط
أرسل المفاتيح من مسارات الخلفية أو العمال أو المهام أو server action الآمنة.
يُعرض مرة واحدة
انسخ المفتاح المُنشأ فورًا واحفظه في مدير الأسرار.
تدوير آمن
انشر مفتاح الاستبدال قبل إلغاء مفتاح الإنتاج القديم.
نطاق الحساب
يُجمَّع الاستخدام في رصيد كلمات مساحة العمل وضوابط الفوترة.
طلب Bearer
عقد الترويسة
fetch('https://turnitpass.com/api/v1/humanize', {
method: 'POST',
headers: {
Authorization: 'Bearer tp_live_your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({ text: draft, language: 'en' })
})
{
"error": "Invalid or revoked API key.",
"code": "invalid_api_key"
}
مفاتيح API
أرسل مفتاح API مع كل طلب. تظهر المفاتيح مرة واحدة فقط عند الإنشاء ويمكن إلغاؤها من مساحة العمل.
Authorization: Bearer tp_live_your_api_key
Content-Type: application/json
POST /api/v1/humanize
Managing keys
إنشاء
أنشئ مفتاحًا مسمّى من مساحة العمل وانسخه فورًا.
إلغاء
عطّل مفتاحًا فورًا. لا يمكن استخدام المفاتيح الملغاة في طلبات جديدة.
حدود المعدل
يمكن تقييد كل مفتاح على حدة بينما يُجمَّع الاستخدام في الحساب.
الفوترة
تشارك جميع المفاتيح رصيد كلمات الحساب وحدود الاشتراك.
ملك مساحة العمل
Key lifecycle
إنشاء مفتاح مسمّى
استخدم اسمًا يصف البيئة أو السطح، مثل Production backend أو Staging worker أو Internal QA.
انسخه مرة واحدة إلى مخزن أسرار
يعرض TurnitPass المفتاح عند الإنشاء فقط. احفظه في مزود النشر أو مدير أسرار CI أو ملف .env المحلي.
راقب الاستخدام عبر status والفوترة
تشارك جميع المفاتيح رصيد الكلمات، بينما تسهّل أسماء المفاتيح معرفة أي دمج نشط.
دُر قبل الإلغاء
أنشئ مفتاح استبدال وانشره وتأكد من سلامة الحركة ثم ألغِ المفتاح القديم من مساحة العمل.
Environment setup
احفظ مفاتيح TurnitPass كأسرار للخادم فقط. تستخدم الأمثلة أدناه أسماء عامة لتناسب Next.js وWorkers ومهام الخادم أو أي بيئة خلفية.
TURNITPASS_API_KEY=tp_live_your_api_key
TURNITPASS_API_BASE_URL=https://turnitpass.com/api/v1
Security best practices
Authentication errors
{
"error": "Invalid or revoked API key.",
"code": "invalid_api_key"
}