رُوجع 2026-11-10 · إصدار API 2026-11-09 · قراءة Markdown
المصادقة ومفاتيح المنتج
تتشارك واجهة مستخدم AiVideoEditor وواجهة REST API ومحوّل MCP خدمات مساحة العمل. يستخدم
عملاء واجهة البرمجة مفتاح منتج، لا رمز OAuth لشبكة اجتماعية أو بيانات اعتماد قاعدة بيانات.
أنشئ المفاتيح على /app/developers بعد تسجيل الدخول إلى مساحة العمل الصحيحة. انسخ
مفتاح النص الصريح pk_v1_… مرة واحدة واحفظه في مدير أسرار أو بيئة محلية
محمية. يحتفظ AiVideoEditor بتجزئة وبادئة عرض.
إرسال مفتاح
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
استخدم HTTPS للمنشأ الموزَّع. أبقِ بيانات الاعتماد بعيدًا عن عناوين URL ومتحكمات المصدر ومحادثات الدردشة ولقطات الشاشة والسجلات. تستخدم تحميلات التخزين المباشرة عنوان URL الموقّع والترويسات المُعادة؛ ولا تحوِّل مفتاح الحامل الخاص بك في AiVideoEditor إلى التخزين.
النطاقات والوصول إلى الحسابات
| النطاق | الإمكانية |
|---|---|
accounts:read | فحص الحسابات والقدرات وإعدادات TikTok |
media:write | حجز عمليات التحميل وإنهائها وإدارتها |
posts:read | عرض المنشورات والتحقق من المسودات ومراقبة الحالة |
posts:write | إنشاء المسودات وتحريرها |
posts:publish | النشر والجدولة والإلغاء وإعادة محاولة عمليات التسليم |
usage:read | قراءة استخدام مساحة العمل ومعلومات الخطة |
webhooks:manage | تسجيل نقاط نهاية خطافات الويب وعرضها وإزالتها |
النطاقات أسماء دقيقة، وليست تسلسلًا هرميًا. امنح فقط ما تحتاجه الواجهة.
يمكن أيضًا أن تقيّد المفاتيح معرّفات الحسابات المتاحة. ما زالت عضوية
مساحة العمل والدور الفعال وقيود الحساب وحالة الخطة سارية. المفتاح ذو
posts:publish لا يكتسب تلقائيًا وصول كتابة المسودات.
تستبعد مجموعة نطاقات المفتاح الافتراضية posts:publish وwebhooks:manage. يمكن
لوكيل المسودات فقط أن يجهّز العمل للمراجعة دون صلاحية إرساله. لا يمكن
للمفاتيح إنشاء مفاتيح أخرى أو تغيير الفوترة.
الإبطال والاستعادة
أبطل المفتاح المخترَق في واجهة المطوّر. راجع عدد مهامه المعلقة أولًا:
الإبطال يوقف العمل غير المرسل بحالة requires_action؛ وهو لا يحذف المسودات.
أنشئ بديلًا بالوصول المناسب وراجع العمل المعلق قبل
الاستئناف. لا تفترض أن الإبطال يمكنه استدعاء إرسال أُرسل خارجيًا بالفعل.
تعني 401 أن بيانات الاعتماد غائبة أو غير صالحة. تعني 403 أن الفاعل
المصادق عليه يفتقر إلى الإذن أو وصول الحساب. إعادة محاولة أيٍّ من هاتين
الاستجابتين مرارًا لن تحل المشكلة. راجع الأخطاء والاستعادة.