TikTok میڈیا URLs: تصدیق شدہ ڈومین اور URL پری فکس
TikTok کا API for Business میڈیا کو video_url، custom_thumbnail_url اور photo_images سے ڈاؤن لوڈ کرتا ہے۔ ہر URL ایسے ڈومین یا URL پری فکس پر ہونا چاہیے جس کی ملکیت ڈیولپر ایپ نے تصدیق کی ہو۔ ڈومین کی تصدیق DNS TXT ریکارڈ سے ہوتی ہے، اور پری فکس کی تصدیق اس کے تحت رکھی گئی سگنیچر فائل سے ہوتی ہے، جو /business/property/add/ اور /business/property/verify/ کے ذریعے ایپ کی ID اور سیکرٹ کے ساتھ جاتی ہے۔
easyCoexistence اپنے ہی تصدیق شدہ URL پری فکس سے آپ کا میڈیا TikTok تک پہنچاتا ہے: publish_tiktok_post Claude، ChatGPT یا آپ کے اپنے کوڈ سے ایک HTTPS لنک لیتا ہے اور TikTok کے ڈاؤن لوڈ کے وقت اسی سے فائل اسٹریم کرتا ہے، اس لیے آپ کے ڈومین کی تصدیق درکار نہیں۔
اس کے بعد سے TikTok ایسی ویڈیو URLs قبول نہیں کرتا جو تصدیق شدہ ڈومین یا URL پری فکس پر نہ ہوں۔
اس کے بعد سے URL پراپرٹی اینڈ پوائنٹس کو ڈیولپر ایپ کا سیکرٹ بھی درکار ہوتا ہے۔
property_type کی قدریں: ڈومین کے لیے 1، URL پری فکس کے لیے 2۔
property_status کی قدریں: pending، verified، اور not verified، جس کا مطلب ہے کہ کوشش ناکام ہوئی اور اسے دوبارہ کرنا ہوگا۔
اس سے پہلے ویڈیو شائع کرنے والے ڈیولپرز کے لیے ان ویڈیو URLs کے ڈومینز خودکار طور پر تصدیق شدہ کر دیے گئے تھے۔
/business/comment/image/upload/ کمنٹ یا ریپلائی کے لیے، ملٹی پارٹ فارم ڈیٹا کے طور پر، سب سے بڑی تصویر قبول کرتا ہے۔
TikTok کون سے URLs ڈاؤن لوڈ کرتا ہے؟
دونوں پبلش اینڈ پوائنٹس کا ہر میڈیا فیلڈ ایک URL ہے جسے کال قبول کرنے کے بعد TikTok خود حاصل کرتا ہے، اس لیے ڈاؤن لوڈ مکمل ہونے تک فائل قابلِ رسائی رہنی چاہیے:
video_url: ویڈیو، جسے TikTok کم از کم 30 منٹ تک درست رکھنے کی سفارش کرتا ہے۔custom_thumbnail_url: ویڈیو کے کور کے طور پر استعمال ہونے والی ایک تصویر (تھمب نیل)۔photo_images: فوٹو پوسٹ کے لیے 35 تصاویر تک۔- ٹائم آؤٹ: TikTok ڈاؤن لوڈ کو ایک گھنٹہ دیتا ہے، اس کے بعد پوسٹ
video_pull_failedیاphoto_pull_failedکے ساتھ ناکام ہو جاتی ہے۔
ڈومین اور URL پری فکس میں کیا فرق ہے؟
یہ اس بات کا تعین کرتا ہے کہ آپ اپنی ملکیت کیا ثابت کرتے ہیں، اور اس کے نتیجے میں کون سے URLs تصدیق شدہ شمار ہوں گے۔ ڈومین ایسے میڈیا کے لیے موزوں ہے جو کسی ہوسٹ پر ہو جس کے آپ مالک ہیں یا جسے آپ کنٹرول کرتے ہیں، جبکہ پری فکس اس فولڈر کے لیے موزوں ہے جو ایسے ہوسٹ پر ہو جہاں آپ صرف فائلیں اپ لوڈ کر سکتے ہیں۔ ہر پراپرٹی قسم کے لیے 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 اور سیکرٹ سے تصدیق کرتی ہیں، اور ان کے درمیان ثبوت رکھا جاتا ہے:
- شامل کریں: POST /business/property/add/ کو
url_property_metaکے ساتھ بھیجیں، جس میںproperty_typeاور url ہوں؛ جواب میں signature ملتا ہے، پری فکس کے لیےfile_nameبھی، اورproperty_status0 ہوتا ہے۔ - ثبوت دیں: ڈومین کے لیے signature کو DNS TXT ریکارڈ میں رکھیں، یا پری فکس کے تحت ایک عوامی فائل میں جس کا نام
file_nameہو اور جس کی ایکسٹینشن صرف .txt ہو۔ - جانچ کریں: اسی
url_property_metaکے ساتھ POST /business/property/verify/ بھیجیں؛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پراپرٹیز کی فہرست کیسے دیکھیں یا ہٹائیں؟
app_id اور سیکرٹ کے ساتھ GET /business/property/list/ بھیجنے پر url_property_info_list واپس آتی ہے، جس کی ہر اندراج میں property_type، url، property_status، signature اور file_name ہوتے ہیں۔ تصدیق شدہ ڈومین کے سب ڈومینز کو اپنی الگ کال کے بغیر تصدیق شدہ سمجھا جاتا ہے، لیکن وہ فہرست میں صرف اسی صورت میں نظر آتے ہیں جب وہ شامل کیے گئے ہوں۔ POST /business/property/delete/ app_id، سیکرٹ اور url_property_meta کے ساتھ ایسی پراپرٹی ہٹا دیتا ہے جس پر ایپ اب مالکانہ حق یا کنٹرول نہیں رکھتی۔
کیا URL کے بجائے فائل اپ لوڈ کی جا سکتی ہے؟
پوسٹس کے لیے نہیں۔ Accounts API صرف URLs سے پبلش کرتا ہے، ڈرافٹس سمیت، اور اس کا واحد اپ لوڈ اینڈ پوائنٹ /business/comment/image/upload/ کمنٹ کی تصویر ملٹی پارٹ فارم ڈیٹا کے طور پر لیتا ہے، JPG، JPEG، WebP یا PNG میں، 5 MB تک، اور کمنٹ یا ریپلائی کے لیے image_uri واپس کرتا ہے۔ چنک فائل اپ لوڈ developers.tiktok.com پر Content Posting API سے تعلق رکھتا ہے، جو اپنی ایپس کے ساتھ ایک الگ API ہے، اور جس میں ٹرانسفر کا طریقہ FILE_UPLOAD کہلاتا ہے۔
غیر تصدیق شدہ URL کے ساتھ کیا ہوتا ہے؟
TikTok اس سے پبلش کرنے سے انکار کر دیتا ہے۔ API for Business کا حوالہ ویڈیوز اور تصاویر کے لیے یہ اصول بیان کرتا ہے، لیکن اس کے لیے کوئی الگ جواب کوڈ نہیں دیتا، اس لیے جواب میں کوڈ اور پیغام پڑھیں۔ developers.tiktok.com پر Content Posting API اسی صورت کو url_ownership_unverified کہتا ہے، HTTP 403 کے ساتھ۔ کسی بھی پراپرٹی کی تصدیق سے پہلے ویڈیو اینڈ پوائنٹ آزمانے کے لیے TikTok ایک ٹیسٹ ویڈیو URL فراہم کرتا ہے جسے تصدیق کی ضرورت نہیں ہوتی:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4easyCoexistence آپ کا میڈیا TikTok تک کیسے پہنچاتا ہے؟
easyCoexistence کا اپنا ایک تصدیق شدہ URL پری فکس ہے، https://easycoexistence.com/api/social/media/ ، جس پر یہ کام کرتا ہے۔ publish_tiktok_post آپ کا HTTPS لنک لیتا ہے، کوئی بھی چیز بھیجنے سے پہلے http:// لنک مسترد کر دیتا ہے، اور TikTok کو اس پری فکس کے تحت ایک لنک دیتا ہے جس میں ایک دستخط شدہ ٹوکن ہوتا ہے جو آپ کی فائل کا نام ظاہر کرتا ہے، 6 گھنٹے بعد ختم ہو جاتا ہے، اور فائل کی ایکسٹینشن برقرار رکھتا ہے۔ جب TikTok اسے حاصل کرتا ہے تو easyCoexistence ٹوکن کی جانچ کرتا ہے، تصدیق کرتا ہے کہ آپ کا لنک عوامی ایڈریس پر HTTPS استعمال کرتا ہے، اور فائل کو آپ کے لنک سے براہ راست اسٹریم کرتا ہے، بشمول رینج درخواستوں اور ری ڈائریکٹس کے، اسے محفوظ کیے بغیر۔ اگر آپ کا لنک ناکام ہو جائے تو 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 اپنے ہی سب ڈومینز کو کور کرتا ہے، خود example.com کو نہیں۔
- پری فکس کی سگنیچر فائل کو ری ڈائریکٹ کے ذریعے پیش کرنا۔ TikTok URL پری فکس کے لیے ری ڈائریکٹس کی پیروی نہیں کرتا اور 3xx جواب کو غلط سمجھتا ہے۔
- سگنیچر فائل کو name.txt.txt کے طور پر محفوظ کرنا۔ TikTok چاہتا ہے کہ فائل کا نام file_name سے مطابقت رکھے، ایک ہی .txt ایکسٹینشن کے ساتھ۔
- پبلش کال کے فوراً بعد فائل ڈیلیٹ کرنا۔ TikTok اسے بعد میں ایک گھنٹے تک ڈاؤن لوڈ کرتا ہے، اور اگر لنک کام کرنا بند کر دے تو پوسٹ ناکام ہو جاتی ہے۔
فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک، جیسے جیسے کنکشنز بڑھتے ہیں قیمت کم ہوتی ہے، پہلے 3 دن فری ٹرائل کے ساتھ۔
اکثر پوچھے جانے والے سوالات
TikTok کو تصدیق شدہ میڈیا URLs کیوں درکار ہیں؟
TikTok کہتا ہے کہ ویڈیو URLs کی ملکیت کی تصدیق اسے کاپی رائٹ شدہ مواد اور صارفین کی حفاظت سے متعلق اپنی پالیسیوں پر عمل کرنے میں مدد دیتی ہے۔
کیا تصدیق شدہ TikTok ڈومین اپنے سب ڈومینز کو کور کرتا ہے؟
ہاں۔ تصدیق شدہ ڈومین کے سب ڈومینز تصدیق شدہ شمار ہوتے ہیں، تاہم /business/property/list/ انہیں صرف اسی صورت میں دکھاتی ہے جب وہ شامل کیے گئے ہوں۔
کیا TikTok کا API for Business S3 یا CDN لنک سے پبلش کر سکتا ہے؟
ہاں، جب لنک ایسے ڈومین یا URL پری فکس کے تحت ہو جسے ایپ نے تصدیق کیا ہو، جیسے کسی بکٹ یا CDN پاتھ پر پری فکس جو آپ کے کنٹرول میں ہو۔
کیا فوٹو پوسٹس کو بھی تصدیق شدہ URLs درکار ہیں؟
ہاں۔ TikTok کا فوٹو اینڈ پوائنٹ واضح کرتا ہے کہ فوٹو پوسٹس غیر تصدیق شدہ فوٹو URLs سے پبلش نہیں ہو سکتیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ