عناوين 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، فلا يحتاج نطاقك إلى توثيق.
منذ ذلك الحين، ترفض TikTok عناوين الفيديو غير الواقعة على نطاق أو بادئة URL موثّقة.
منذ ذلك الحين، تتطلب نقاط نهاية ممتلكات URL أيضاً secret تطبيق المطوّر.
قيم property_type: القيمة 1 للنطاق، والقيمة 2 لبادئة الروابط.
قيم property_status: pending، وverified، وnot verified، وتعني أن المحاولة فشلت ويجب تكرارها.
أما المطوّرون الذين نشروا فيديوهات قبل ذلك، فقد ضُبطت نطاقات عناوين الفيديو لديهم على موثّقة تلقائياً.
أكبر حجم صورة تقبله /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 لكل نوع ممتلكات:
| Domain | URL prefix | |
|---|---|---|
| What it is | A site you own, such as example.com or a subdomain | https:// plus a host, a path and a final /, such as https://www.example.com/videos/ |
| Proof | A DNS TXT record holding the signature | A file named file_name, holding the signature, uploaded under the prefix |
| Covers | URLs on the domain and its subdomains | URLs that begin with the prefix |
| Leaves out | The parent: verifying video.example.com leaves example.com unverified | Sibling paths: /folder/user/ leaves /folder/public/ unverified |
| Redirects | Not applicable | Not followed; a prefix answering 3xx is invalid |
كيف تتحقق من ممتلكة؟
عبر استدعاءين يصادقان باستخدام app_id وsecret الخاصين بتطبيق المطوّر بدلاً من رمز الحساب، ويوضع الدليل بينهما:
- الإضافة: POST /business/property/add/ مع
url_property_metaالذي يحويproperty_typeوurl، فتعيد الإجابة signature، ومعهfile_nameللبادئة، معproperty_status0. - الإثبات: ضع التوقيع في سجل DNS TXT للنطاق، أو في ملف عام باسم
file_name، بامتداد .txt واحد، تحت البادئة. - التحقق: POST /business/property/verify/ مع
url_property_metaنفسه؛ القيمةproperty_status1 تعني موثّقة، والقيمة 2 تعني أن المحاولة فشلت.
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 رابط فيديو تجريبياً لا يحتاج إلى توثيق:
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 تنزيل الملف ويفشل المنشور.
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 بعد ذلك، لمدة تصل إلى ساعة، وتفشل المنشور إذا توقف الرابط عن العمل.
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
لماذا تشترط TikTok وسائط فيديو بعناوين URL موثّقة؟
تقول TikTok إن توثيق ملكية عناوين URL الخاصة بالفيديو يساعدها على الالتزام بسياساتها المتعلقة بالمحتوى المحمي بحقوق النشر وبسلامة المستخدمين.
هل يغطي نطاق TikTok الموثّق نطاقاته الفرعية؟
نعم. تُعدّ النطاقات الفرعية لنطاق موثّق موثّقة، لكن /business/property/list/ يعرضها فقط إذا أُضيفت.
هل يمكن لواجهة API for Business من TikTok النشر من رابط S3 أو CDN؟
نعم، متى كان الرابط واقعاً ضمن نطاق أو بادئة أثبت التطبيق ملكيتها، مثل بادئة على حاوية S3 أو مسار CDN تتحكم فيه.
هل تحتاج منشورات الصور إلى عناوين URL موثّقة أيضاً؟
نعم. تنص نقطة نهاية الصور في TikTok على أن منشورات الصور لا يمكن نشرها من عناوين صور غير موثّقة.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في