TikTok मीडिया यूआरएल: सत्यापित डोमेन और यूआरएल प्रीफ़िक्स
TikTok का API for Business मीडिया को यूआरएल से डाउनलोड करता है: video_url, custom_thumbnail_url और photo_images। हर यूआरएल ऐसे डोमेन या यूआरएल प्रीफ़िक्स पर होना चाहिए जिसका स्वामित्व डेवलपर ऐप ने सत्यापित किया हो। डोमेन को DNS TXT रिकॉर्ड से सत्यापित किया जाता है, प्रीफ़िक्स को उसके नीचे रखी गई सिग्नेचर फ़ाइल से, /business/property/add/ और /business/property/verify/ के ज़रिए, ऐप की ID और secret के साथ।
easyCoexistence अपने सत्यापित URL प्रीफ़िक्स से आपका मीडिया TikTok तक पहुँचाता है: publish_tiktok_post Claude, ChatGPT या आपके अपने कोड से एक HTTPS लिंक लेता है और TikTok के डाउनलोड के समय उसी से फ़ाइल स्ट्रीम करता है, इसलिए आपके डोमेन को सत्यापन की ज़रूरत नहीं।
इसके बाद से TikTok उन वीडियो URL को ठुकरा देता है जो सत्यापित डोमेन या URL प्रीफ़िक्स पर नहीं हैं।
इसके बाद से URL प्रॉपर्टी एंडपॉइंट के लिए डेवलपर ऐप का secret भी ज़रूरी है।
property_type के मान: 1 डोमेन के लिए, 2 URL प्रीफ़िक्स के लिए।
property_status के मान: pending, verified, और not verified, जिसका अर्थ है कि प्रयास विफल रहा और उसे दोबारा करना होगा।
उससे पहले वीडियो प्रकाशित करने वाले डेवलपर के उन वीडियो URL के डोमेन अपने-आप सत्यापित कर दिए गए थे।
कमेंट या जवाब के लिए मल्टीपार्ट फ़ॉर्म डेटा के रूप में /business/comment/image/upload/ जितनी सबसे बड़ी इमेज स्वीकार करता है।
TikTok कौन से URL डाउनलोड करता है?
दोनों पब्लिश एंडपॉइंट के हर मीडिया फ़ील्ड एक ऐसा 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 से प्रमाणित होती हैं, और इनके बीच प्रमाण रखा जाता है:
- जोड़ें:
url_property_metaके साथ POST /business/property/add/, जिसमें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 और secret के साथ GET /business/property/list/ url_property_info_list लौटाता है, हर प्रविष्टि में property_type, url, property_status, signature और file_name के साथ। सत्यापित डोमेन के सबडोमेन को अपनी अलग कॉल के बिना सत्यापित माना जाता है, पर सूची में वे केवल तभी दिखते हैं जब उन्हें जोड़ा गया हो। app_id, secret और url_property_meta के साथ POST /business/property/delete/ उस प्रॉपर्टी को हटाता है जिस पर ऐप का अब स्वामित्व या नियंत्रण नहीं है।
URL के बजाय फ़ाइल अपलोड कर सकते हैं?
पोस्ट के लिए नहीं। Accounts API केवल URL से पब्लिश करता है, ड्राफ़्ट भी, और उसका एकमात्र अपलोड एंडपॉइंट, /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 तक कैसे पहुँचाता है?
उसके अपने एक सत्यापित 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 को सत्यापित मीडिया URL क्यों चाहिए?
TikTok कहता है कि वीडियो URL का स्वामित्व सत्यापित करने से उसे कॉपीराइट वाली सामग्री और उपयोगकर्ता सुरक्षा संबंधी अपनी नीतियों का पालन करने में मदद मिलती है।
क्या सत्यापित TikTok डोमेन उसके सबडोमेन को कवर करता है?
हाँ। सत्यापित डोमेन के सबडोमेन सत्यापित माने जाते हैं, हालाँकि /business/property/list/ उन्हें केवल तभी दिखाता है जब वे जोड़े गए हों।
क्या TikTok का API for Business S3 या CDN लिंक से पब्लिश कर सकता है?
हाँ, जब लिंक ऐसे डोमेन या URL प्रीफ़िक्स के नीचे हो जिसे ऐप ने सत्यापित किया है, जैसे आपके नियंत्रण वाले बकेट या CDN पथ पर कोई प्रीफ़िक्स।
क्या फ़ोटो पोस्ट को भी सत्यापित URL चाहिए?
हाँ। TikTok का फ़ोटो एंडपॉइंट बताता है कि असत्यापित फ़ोटो URL से फ़ोटो पोस्ट पब्लिश नहीं की जा सकतीं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित