AiVideoEditor
ابدأ مجانًا
القائمة

رُوجع 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 أن الفاعل المصادق عليه يفتقر إلى الإذن أو وصول الحساب. إعادة محاولة أيٍّ من هاتين الاستجابتين مرارًا لن تحل المشكلة. راجع الأخطاء والاستعادة.