رُوجع 2026-11-11 · إصدار API 2026-11-09 · قراءة Markdown
النشر والجدولة
يتكون منشور AiVideoEditor من مسودة ذات إصدارات وتسليمات مستقلة لحساباتها المحددة. حفظ المسودة متسامح؛ والحفظ الناجح لا يعني أن كل وجهة قابلة للنشر.
تجهيز منشور
- اقرأ
/api/v1/accountsو/api/v1/capabilitiesبالمفتاح المقصود. - ارفع وأنهِ أي وسائط مطلوبة.
- أنشئ مسودة بـ
POST /api/v1/posts، أو حرّر بـPATCH /api/v1/posts/{id}. قدّمexpectedVersionالحالية عند التحرير واحفظ الإصدار المُعاد. - اضبط تنسيق الوجهة وتجاوزات المتغيرات الصريحة لكل حساب حيث يلزم. يحدد مرجع واجهة البرمجة حقول الطلب.
- تحقق باستخدام
POST /api/v1/posts/{id}/validate. قد يحتوي HTTP 200 علىvalid: false؛ افحص كل مشكلة قبل الإرسال. الحسابات غير الصالحة لا تُزال بصمت من الجمهور.
النشر الآن أو لاحقًا
يرسل POST /posts/{id}/publish المسودة الحالية. يتطلب POST /posts/{id}/schedule
القيم scheduledAt وtimezone وexpectedVersion. يجب أن تكون اللحظة المجدولة
مستقبلية وضمن 90 يومًا. خزّن طابعًا زمنيًا UTC ومنطقة عرض IANA منفصلة؛
وحُلّ غموض التوقيت الصيفي قبل الإرسال.
استخدم Idempotency-Key مميزًا لكل عملية تغيير جديدة. احتفظ بذلك المفتاح
وبجسم الطلب الدقيق قبل الإرسال. بعد انتهاء المهلة، أعد تشغيل الطلب المطابق
بالمفتاح نفسه. غيّر المفتاح فقط عند طلب عملية جديدة عمدًا. يعيد تحرير أو جدولة
مسودة قديمة revision_conflict؛ فأعد قراءة أحدث محتوى واراجعه
بدلًا من الكتابة فوقه بعمى.
الاستجابة 202 تعني القبول للإرسال. وهي ليست دليلًا على النشر.
سجّل معرّفات التسليم وراقب GET /posts/{id} أو خطافات الويب الموقّعة للعملاء.
استخدم استقصاءً محدودًا بتأخيرات متزايدة؛ وتوقف عند النتائج النهائية أو
تسليم بشري بدلًا من التكرار بلا نهاية.
نتائج كل وجهة
يمكن أن تستقر عمليات التسليم باستقلالية. قد تنشر وجهة واحدة بينما تحتاج
أخرى إلى إعادة ربط أو موافقة. اعرض كل حالة ورابط المنشور الأصلي عند وجوده.
أعد المحاولة فقط لفشل معروف مؤهل باستخدام POST /deliveries/{id}/retry.
يجب عدم إعادة إنشاء الوجهات الناجحة لاستعادة وجهة فاشلة. النتيجة
الخارجية المجهولة تحتاج إلى مطابقة أو مراجعة، لا إلى إرسال جديد.
ألغِ باستخدام POST /deliveries/{id}/cancel ما دام العمل غير مطالب به بأمان.
تعني too_late_to_cancel أن الإرسال تجاوز حدود الإلغاء الآمن؛
ولا تعني أن المنشور الخارجي أُزيل.
المراجعة البشرية لـ TikTok
اقرأ /accounts/{id}/tiktok/settings لإعدادات المنشئ الحالية وخيارات الخصوصية المتاحة.
قراءة الإعدادات أو حفظ مسودة لا توفر الموافقة.
يتضمن consent_required تسليمًا آمنًا عبر requiresAction إلى محرِّر التأليف
المصادق عليه. يراجع شخص مصرَّح له الفيديو ونص المنشور والوجهة
بالضبط ويؤكد صراحة الخيارات المطلوبة هناك. لا يمكن لمفاتيح المنتج وأدوات MCP
التأكيد نيابة عنه. تغييرات المحتوى أو الهوية تتطلب مراجعة جديدة.
التسليم لا يمنح عضوية أو وصولًا بحد ذاته.
أدوات محرِّر التأليف
استخدم Add media لرفع ملف أو اختيار عنصر موجود من المكتبة. نص المنشور مشترك حتى ينشئ Customize content متغيرًا خاصًا بالحساب. أدوات الإيموجي والوسوم تُدرج نصًا عاديًا عند المؤشر.
تجمع Posting options إعدادات الحساب المحدد. تبقى الخيارات الإلزامية مرئية؛ وتظل المجموعات الاختيارية مطوية. تنطبق التغييرات على ذلك الحساب فقط. يعرض Preview المسودة الفعالة دون حفظها أو إرسالها، بما في ذلك المسودات غير المكتملة؛ وقد يختلف العرض الأصلي للمنصة.
استخدم مراجع الأصول الخاصة للأغلفة والصور المصغرة المجدولة. يجب أن تبقى البدائل ذات عناوين URL العامة قابلة للوصول وقت التسليم. يُخزَّن محتوى التسميات التوضيحية مع الإعدادات غير القابلة للتغيير بدلًا من الاعتماد على ملف محلي مؤقت. يدعم رفع مستندات LinkedIn حاليًا PDF؛ وتظل صيغ Office مقيّدة حتى تنفيذ التحقق من التوقيع.
راجع مرجع القدرات للأدوات القياسية وحدود التكامل. سلوك التنسيق والتأكيد الجديد يتطلب ترحيلات قاعدة البيانات المقابلة قبل النشر.