نشر الفيديوهات على تيك توك من خلال زاكي بوست

يمنح زاكي بوست مستخدميه القدرة على ربط حساباتهم الشخصية على تيك توك ونشر الفيديوهات إليها بشكل برمجي. بفضل هذه الميزة، لن يحتاج المطور أو المستخدم إلى المرور بتعقيدات إنشاء تطبيق خاص في TikTok Developer Portal أو انتظار موافقات المراجعة، بل يمكنه الاعتماد مباشرة على واجهتنا البرمجية الجاهزة والآمنة لإدارة حسابه والنشر عليه بكل سهولة.

آلية العمل بسيطه وامنه : كل ما يتطلبه الأمر هو ربط حسابك الشخصي على تيك توك بمنصتنا عبر شاشة المصادقة الرسمية الخاصة بتيك توك. بمجرد إتمام هذه الخطوة، ستحصل فوراً على مفاتيح وصول برمجية مخصصة لحسابك، والتي تمنحك الحرية الكاملة لأتمتة ونشر فيديوهاتك مباشرة باستخدام أي بيئة تطوير أو أداة برمجية تفضلها.

1. آلية العمل من ناحية المستخدم

تتلخص العملية في ثلاث خطوات:

1. الحصول على مفتاحي الوصول الخاصين بالحساب (client_key و client_secret) من صفحة إعدادات مفاتيح API.
2. ربط حساب تيك توك الشخصي من خلال زر "ربط حساب TikTok"، وهي الخطوة الوحيدة التي يمر فيها المستخدم بشاشة الموافقة الرسمية لتيك توك.
3. استخدام مفتاحي الوصول مع معرّف الحساب الذي تم ربطه (internal_token) لإرسال طلبات النشر من أي بيئة برمجية تدعم إرسال طلبات HTTP.

بعد إتمام هذه الخطوات، تتولى منصة زاكي بوست التفاصيل التقنية المرتبطة بالتعامل مع تيك توك: تجديد التوكنات، تخزينها بشكل مشفّر، إرسال طلب النشر الفعلي، والتحقق من نتيجته بعد فترة قصيرة من إرساله.

2. مفاتيح API الخاصة بالحساب

عند إنشاء الحساب في زاكي بوست، يتم توليد مفتاحين تلقائيًا وربطهما بشكل دائم بالحساب:

هذان المفتاحان ثابتان لضمان استقرار الربط البرمجي الخاص بك. يمكنك دائماً الاطلاع عليهما أو نسخهما في أي وقت من خلال صفحة الإعدادات الخاصة بمفاتيح API، مع التوصية بالحفاظ على سرية مفاتيحك وعدم مشاركتها مع أي جهات غير موثوقة.

هذان المفتاحان لا علاقة لهما بحساب تيك توك ذاته، وإنما هما وسيلة المصادقة بين المستخدم وخادم زاكي بوست. يجب إرسالهما مع كل طلب نشر عبر ترويستي HTTP التاليتين:

X-ZakiPost-Client-Key: zp_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
X-ZakiPost-Client-Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

بما أن هذه المفاتيح هي بيانات اعتماد HTTP قياسية، يمكن استخدامها من أي بيئة قادرة على إرسال طلبات HTTP، بصرف النظر عن لغة البرمجة أو الأداة المستخدمة.

3. ربط حساب تيك توك

يوفّر زاكي بوست زر "ربط حساب TikTok" داخل لوحة التحكم، وعند النقر عليه يتم تنفيذ التسلسل التالي:

1. توليد رمز حماية عشوائي (state) يُحفظ مؤقتًا لمنع محاولات التزوير عبر الطلبات.
2. إعادة توجيه المستخدم إلى شاشة الموافقة الرسمية الخاصة بتيك توك.
3. بعد موافقة المستخدم، يُعاد توجيهه إلى زاكي بوست التي تتحقق من صحة الطلب وتستبدل كود التفويض بتوكن وصول صالح.
4. يتم تشفير التوكن وتخزينه بأمان، ولا يُعرض في أي وقت للمستخدم أو لأي طرف آخر.
5. يُولَّد معرّف داخلي خاص بهذا الحساب يُستخدم لاحقًا عند إرسال طلبات النشر.

بعد اكتمال هذه الخطوة، يظهر حساب تيك توك ضمن قائمة الحسابات المرتبطة بالمستخدم، ويصبح بالإمكان النشر إليه عبر واجهة برمجة التطبيقات الخاصة بـ زاكي بوست.

4. نشر فيديو عبر API

تستقبل نقطة الوصول الخاصة بالنشر طلبات POST بالصيغة التالية:

POST https://api.zakipost.com/v1/tiktok/publish
Content-Type: application/json
X-ZakiPost-Client-Key: zp_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
X-ZakiPost-Client-Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

{
  "video_url": "https://example.com/video.mp4",
  "tiktok_account_id": "internal-token-uuid",
  "title": "نص الوصف مع الهاشتاجات",
  "privacy_level": "PUBLIC_TO_EVERYONE",
  "disable_comment": false,
  "disable_duet": false,
  "disable_stitch": false,
  "ai_generated_content": true
}

شرح الحقول

الاستجابة عند النجاح

{
  "success": true,
  "message": "Publishing process started.",
  "data": {
    "publish_id": "v_pub_xxxxxxxxxxxxxxxx"
  }
}

تشير هذه الاستجابة إلى أن طلب النشر تم قبوله وبدأت عملية التنفيذ الفورية. لا يتطلب الأمر الانتظار طويلاً، حيث تتم المعالجة والنشر الفعلي للفيديو على حساب تيك توك في ثواني معدودة (عادتاً خلال 15 ثانية) من لحظة إرسال الطلب بنجاح.

5. الأخطاء الشائعة ومعانيها

6. ملاحظات هامة حول مستوى الخصوصية وحدود النشر

تخضع عمليات النشر إلى تيك توك من خلال أي تطبيق خارجي، بما في ذلك زاكي بوست، لسياسات تيك توك الخاصة بواجهة Content Posting API. تشمل هذه السياسات قيودًا قد تتغير من وقت لآخر، مثل مستوى الخصوصية الفعلي المتاح للنشر، وعدد عمليات النشر المسموح بها لكل حساب خلال فترة زمنية محددة. يُنصح المستخدم بالتحقق من حالة حسابه وخياراته الفعلية المتاحة من خلال صفحة إعدادات مفاتيح API.

7. ملخص سريع