تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

عناوين URL لوسائط TikTok: نطاقات وبادئات URL موثّقة

تنزّل واجهة API for Business من TikTok وسائط المنشورات من عناوين URL: video_url وcustom_thumbnail_url وphoto_images. يجب أن يقع كل عنوان URL ضمن نطاق أو بادئة URL أثبت تطبيق المطوّر ملكيتها. يُتحقق من النطاق بسجل DNS TXT، ومن البادئة بملف توقيع يوضع ضمنها، وذلك عبر /business/property/add/ و/business/property/verify/ باستخدام app_id وsecret الخاصين بالتطبيق.

تقدّم easyCoexistence وسائطك إلى TikTok من بادئة URL موثّقة خاصة بها: تأخذ publish_tiktok_post رابط HTTPS من Claude أو ChatGPT أو من كودك، وتبث الملف منه عندما تنزّله TikTok، فلا يحتاج نطاقك إلى توثيق.

Nov 16, 2023

منذ ذلك الحين، ترفض TikTok عناوين الفيديو غير الواقعة على نطاق أو بادئة URL موثّقة.

Oct 15, 2025

منذ ذلك الحين، تتطلب نقاط نهاية ممتلكات URL أيضاً secret تطبيق المطوّر.

1 / 2

قيم property_type: القيمة 1 للنطاق، والقيمة 2 لبادئة الروابط.

0, 1, 2

قيم property_status: pending، وverified، وnot verified، وتعني أن المحاولة فشلت ويجب تكرارها.

Apr 7, 2023

أما المطوّرون الذين نشروا فيديوهات قبل ذلك، فقد ضُبطت نطاقات عناوين الفيديو لديهم على موثّقة تلقائياً.

5 MB

أكبر حجم صورة تقبله /business/comment/image/upload/ كبيانات نموذج متعددة الأجزاء (multipart form data)، لتعليق أو رد.

أي عناوين URL تنزّلها TikTok؟

كل حقل وسائط في نقطتي النشر عنوان URL تجلبه TikTok بنفسها بعد قبول الاستدعاء، لذا يجب أن يبقى الملف متاحاً حتى تنتهي عملية التنزيل:

  • video_url: الفيديو، وتوصي TikTok بإبقائه صالحاً لمدة 30 دقيقة على الأقل.
  • custom_thumbnail_url: صورة تُستخدم غلافاً للفيديو.
  • photo_images: حتى 35 صورة لمنشور صور.
  • المهلة الزمنية: تمنح TikTok التنزيل ساعة واحدة، ثم تفشل المنشور برمز video_pull_failed أو photo_pull_failed.

ما الفرق بين النطاق وبادئة URL؟

ما تثبت ملكيته، وبالتالي أي عناوين URL تُعدّ موثّقة. يناسب النطاق الوسائط الموجودة على مضيف تملكه أو تتحكم فيه، وتناسب البادئة مجلداً على مضيف لا يمكنك سوى رفع الملفات إليه. هذه قواعد TikTok لكل نوع ممتلكات:

DomainURL prefix
What it isA site you own, such as example.com or a subdomainhttps:// plus a host, a path and a final /, such as https://www.example.com/videos/
ProofA DNS TXT record holding the signatureA file named file_name, holding the signature, uploaded under the prefix
CoversURLs on the domain and its subdomainsURLs that begin with the prefix
Leaves outThe parent: verifying video.example.com leaves example.com unverifiedSibling paths: /folder/user/ leaves /folder/public/ unverified
RedirectsNot applicableNot followed; a prefix answering 3xx is invalid

كيف تتحقق من ممتلكة؟

عبر استدعاءين يصادقان باستخدام app_id وsecret الخاصين بتطبيق المطوّر بدلاً من رمز الحساب، ويوضع الدليل بينهما:

  • الإضافة: POST /business/property/add/ مع url_property_meta الذي يحوي property_type وurl، فتعيد الإجابة signature، ومعه file_name للبادئة، مع property_status 0.
  • الإثبات: ضع التوقيع في سجل DNS TXT للنطاق، أو في ملف عام باسم file_name، بامتداد .txt واحد، تحت البادئة.
  • التحقق: POST /business/property/verify/ مع url_property_meta نفسه؛ القيمة property_status 1 تعني موثّقة، والقيمة 2 تعني أن المحاولة فشلت.
Add a URL prefix
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
  }'

# data.url_property_info: url, property_type, property_status (0), signature, file_name

كيف تعرض الممتلكات أو تحذفها؟

يعيد GET /business/property/list/ مع app_id وsecret القيمة url_property_info_list، وكل مدخلة فيها property_type وurl وproperty_status وsignature وfile_name. النطاقات الفرعية لنطاق موثّق تُعدّ موثّقة دون استدعاء خاص بها، لكنها لا تظهر في القائمة إلا إذا أُضيفت. يُزيل POST /business/property/delete/ مع app_id وsecret وurl_property_meta ممتلكة لم يعد التطبيق يملكها أو يتحكم فيها.

هل يمكن رفع ملف بدلاً من عنوان URL؟

لا بالنسبة للمنشورات. تنشر Accounts API من عناوين URL فقط، بما فيها المسودات، ونقطة الرفع الوحيدة فيها، /business/comment/image/upload/، تأخذ صورة التعليق كبيانات نموذج متعدد الأجزاء، بصيغ JPG وJPEG وWebP وPNG حتى 5 MB، وتعيد image_uri للتعليق أو الرد. أما الرفع المجزّأ للملفات فيتبع Content Posting API على developers.tiktok.com، وهي واجهة منفصلة لها تطبيقاتها الخاصة، وتُسمّى فيها طريقة النقل FILE_UPLOAD، لذا لا تخلطها بهذا الرفع.

ماذا يحدث لعنوان URL غير موثّق؟

ترفض TikTok النشر منه. يذكر مرجع API for Business القاعدة للفيديوهات والصور، لكنه لا يسمّي لها رمز إرجاع خاصاً بها، لذا اقرأ الرمز والرسالة في الاستجابة. تعرض Content Posting API على developers.tiktok.com الحالة نفسها بالاسم url_ownership_unverified وبرمز HTTP 403. ولتجربة نقطة نشر الفيديو قبل توثيق أي ممتلكة، تنشر TikTok رابط فيديو تجريبياً لا يحتاج إلى توثيق:

TikTok's test video URL for /business/video/publish/
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4

كيف تصل وسائط easyCoexistence إلى TikTok؟

عبر بادئة URL موثّقة واحدة خاصة بها، https://easycoexistence.com/api/social/media/. تقبل publish_tiktok_post رابطك بصيغة HTTPS، وترفض http:// قبل إرسال أي شيء، ثم تمنح TikTok رابطاً تحت هذه البادئة يحمل رمزاً موقّعاً يسمّي ملفك، وتنتهي صلاحيته بعد 6 ساعات، ويحتفظ بامتداد ملفك. عندما تجلبه TikTok، تتحقق easyCoexistence من الرمز، وتتأكد من أن رابطك يستخدم HTTPS على عنوان عام، ثم تبث الملف مباشرة من رابطك، مع range requests وإعادة التوجيه، دون تخزينه. إذا فشل رابطك، لا تستطيع TikTok تنزيل الملف ويفشل المنشور.

What TikTok receives in place of your link
Your link:       https://cdn.example.com/videos/launch.mp4
Sent to TikTok:  https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4

الأخطاء الشائعة

  • التحقق من نطاق فرعي واستضافة الملفات على نطاقه الأم. النطاق الموثّق video.example.com يغطي نطاقاته الفرعية فقط، لا النطاق الأم نفسه.
  • تقديم ملف توقيع البادئة عبر إعادة توجيه. لا تتبع TikTok إعادة التوجيه لبادئة URL، وتعامل الإجابة 3xx على أنها غير صالحة.
  • حفظ ملف التوقيع باسم name.txt.txt. تريد TikTok أن يطابق اسم الملف file_name، بامتداد .txt واحد فقط.
  • حذف الملف مباشرة بعد استدعاء النشر. تنزّله TikTok بعد ذلك، لمدة تصل إلى ساعة، وتفشل المنشور إذا توقف الرابط عن العمل.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

لماذا تشترط TikTok وسائط فيديو بعناوين URL موثّقة؟

تقول TikTok إن توثيق ملكية عناوين URL الخاصة بالفيديو يساعدها على الالتزام بسياساتها المتعلقة بالمحتوى المحمي بحقوق النشر وبسلامة المستخدمين.

هل يغطي نطاق TikTok الموثّق نطاقاته الفرعية؟

نعم. تُعدّ النطاقات الفرعية لنطاق موثّق موثّقة، لكن /business/property/list/ يعرضها فقط إذا أُضيفت.

هل يمكن لواجهة API for Business من TikTok النشر من رابط S3 أو CDN؟

نعم، متى كان الرابط واقعاً ضمن نطاق أو بادئة أثبت التطبيق ملكيتها، مثل بادئة على حاوية S3 أو مسار CDN تتحكم فيه.

هل تحتاج منشورات الصور إلى عناوين URL موثّقة أيضاً؟

نعم. تنص نقطة نهاية الصور في TikTok على أن منشورات الصور لا يمكن نشرها من عناوين صور غير موثّقة.

تابع القراءة

كيف تنشر فيديو على TikTok عبر واجهة برمجة التطبيقات (API)انشر فيديو على TikTok عبر واجهة TikTok للأعمال، مع نقطة النشر وجسم JSON وshare_id المُعاد وطلب الحالة، بأمثلة curl وPython.إعدادات منشورات TikTok عبر API: الخصوصية والتعليقات وDuet وStitchإعدادات TikTok التي تقبلها نقاط النشر: الخصوصية والتعليقات وDuet وStitch والغلاف والوسوم، والقيم التي يسمح بها كل حساب.متطلبات فيديو TikTok لواجهة برمجة التطبيقات (API): الصيغة والحجم والمدةالفيديوهات التي تنشرها TikTok API for Business: MP4 أو MOV أو WebM، من 3 إلى 600 ثانية، حتى 1 GB، و23 إلى 60 إطارًا في الثانية، من رابط يُنزله TikTok بنفسه.منشورات الصور وعروض الشرائح على TikTok عبر API: حتى 35 صورةكيف تنشر واجهة TikTok للأعمال منشورات الصور: من 1 إلى 35 صورة بصيغة JPEG أو WebP حتى 20 ميغابايت لكل صورة، مع عنوان وتعليق وصورة غلاف.وضع علامة على المحتوى المُولَّد بالذكاء الاصطناعي في TikTok عبر APIكيف تضع علامة على الفيديوهات المُولَّدة بالذكاء الاصطناعي عبر TikTok API باستخدام post_info.is_ai_generated، وما تشترطه سياسة TikTok.كيفية متابعة حالة نشر منشور TikTok عبر واجهة برمجة التطبيقات (API)متابعة منشور TikTok المرسل عبر واجهة برمجة التطبيقات (API): share_id، والحالات PROCESSING_DOWNLOAD وPUBLISH_COMPLETE وFAILED، ومعرّفات المنشور وأسباب الفشل.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في