TikTok एपीआई से पोस्ट का पब्लिश स्टेटस कैसे जांचें
TikTok एपीआई से की गई पोस्ट एसिंक्रोनस तरीके से पब्लिश होती हैं: पब्लिश कॉल एक share_id लौटाती है, और उस ID को publish_id के रूप में GET /business/publish/status/ को भेजने पर पता चलता है कि पोस्ट किस स्थिति में है। स्टेटस जब तक TikTok फ़ाइल डाउनलोड करता है तब तक PROCESSING_DOWNLOAD रहता है, मॉडरेशन पास होकर पोस्ट पब्लिश होने पर PUBLISH_COMPLETE, और पोस्ट फ़ेल होने पर frame_rate_check_failed जैसे कारण के साथ FAILED।
easyCoexistence publish_tiktok_post से TikTok पर पब्लिश करता है और हर पोस्ट को get_tiktok_publish_status से ट्रैक करता है, चाहे Claude, ChatGPT या आपके अपने कोड से; इसलिए आपका AI TikTok का स्टेटस और कोई भी फ़ेल होने का कारण वैसा ही देखता है जैसा वह अभी है।
PUBLISH_COMPLETE के बाद पोस्ट ID कितनी देर में आ सकती हैं; ID गायब हों तो TikTok तीन मिनट बाद दोबारा कोशिश करने को कहता है।
1 GB की पोस्ट फ़ाइल डाउनलोड होने में लगने वाले समय का TikTok का सामान्य अनुमान; असल समय आकार और नेटवर्क पर निर्भर करता है।
फ़ाइल अपलोड पूरा होने के बाद पोस्ट के सार्वजनिक होने का सामान्यतः सबसे लंबा इंतज़ार; मैनुअल मॉडरेशन में इससे ज़्यादा समय लग सकता है।
डाउनलोड टाइमआउट, जिसके बाद TikTok पोस्ट को video_pull_failed या photo_pull_failed के साथ फ़ेल कर देता है।
पोस्ट को ट्रैक क्यों करना पड़ता है?
क्योंकि TikTok पोस्ट को बैकग्राउंड में पब्लिश करता है। पब्लिश कॉल एक टास्क शुरू करती है और तुरंत share_id लौटाती है; फिर TikTok अपने यूआरएल से फ़ाइल डाउनलोड करता है, फ़ॉर्मैट जाँचता है, मॉडरेशन चलाता है और पोस्ट को सार्वजनिक करता है। कॉल सफल होने के बाद भी पोस्ट फ़ेल हो सकती है।
कौन-से स्टेटस होते हैं?
GET /business/publish/status/ खाते का business_id और publish_id के रूप में share_id लेता है, और चार में से एक स्टेटस लौटाता है:
PROCESSING_DOWNLOAD: TikTok अपने यूआरएल से कंटेंट डाउनलोड कर रहा है।PUBLISH_COMPLETE: पोस्ट मॉडरेशन पास कर चुकी है और पब्लिश हो गई है; सार्वजनिक रूप से दिखने परpost_idsमें वह शामिल होती है।- FAILED: पब्लिश रुक गया है, और reason बताता है कि क्यों।
SEND_TO_USER_INBOX: ड्राफ़्ट अपलोड हुआ और TikTok ने क्रिएटर के इनबॉक्स को सूचित किया; यह केवल ड्राफ़्ट पर लागू होता है।
पब्लिश होने में कितना समय लगता है?
TikTok कोई निश्चित समय नहीं देता। डाउनलोड फ़ाइल के आकार और नेटवर्क पर निर्भर करता है, और TikTok का सामान्य अनुमान है कि 1 GB फ़ाइल के लिए 30 मिनट काफ़ी हैं, जिसकी सीमा एक घंटा है। उसके बाद पोस्ट आम तौर पर 2 मिनट में सार्वजनिक हो जाती है, या मैनुअल मॉडरेशन की ज़रूरत हो तो बाद में, और पोस्ट ID स्टेटस में दिखने में तीन मिनट तक और लग सकते हैं।
फ़ेल होने के कारणों का क्या मतलब है?
reason बताता है कि पोस्ट को किस चीज़ ने रोका। कुछ का मतलब है कि फ़ाइल बदलनी होगी, और कुछ में दोबारा कोशिश काम कर सकती है:
file_format_check_failed,duration_check_failed,frame_rate_check_failed,picture_size_check_failed: फ़ाइल किसी फ़ॉर्मैट नियम को तोड़ती है, और TikTok इन्हें दोबारा कोशिश के योग्य नहीं मानता।video_pull_failed,photo_pull_failed: TikTok फ़ाइल डाउनलोड नहीं कर सका, या एक घंटे के भीतर नहीं कर सका; यूआरएल सार्वजनिक रूप से पहुँच योग्य होते ही दोबारा कोशिश करें।- internal: TikTok की सेवा का कोई हिस्सा उपलब्ध नहीं था, और दोबारा कोशिश ठीक है।
spam_risk_too_many_posts,spam_risk,spam_risk_text: TikTok ने पोस्ट को मात्रा, व्यवहार या कैप्शन के कंटेंट के कारण रोका।auth_removed: प्रोसेसिंग के दौरान खाते ने ऐप की एक्सेस वापस ले ली, और TikTok दोबारा कोशिश न करने को कहता है।spam_risk_user_banned_from_posting: खाते पर नई पोस्ट बनाने पर प्रतिबंध है।
पोस्ट ID किसलिए है?
बाद में पोस्ट खोजने के लिए। TikTok के रेफ़रेंस के अनुसार पोस्ट ID को /business/video/list/ में filters.video_ids के रूप में पास किया जाता है, ताकि पोस्ट के मेट्रिक्स पढ़े जा सकें। कमेंट कॉल के लिए, खाते की वीडियो लिस्ट से पोस्ट का item_id video_id के रूप में लिया जाता है, और यही easyCoexistence के कमेंट टूल post_id के रूप में लेते हैं।
easyCoexistence पोस्ट को कैसे ट्रैक करता है?
publish_tiktok_post TikTok का share_id लौटाता है, साथ में यह नोट कि TikTok पोस्ट प्रोसेस कर रहा है। get_tiktok_publish_status वह share_id लेकर TikTok का मौजूदा स्टेटस लौटाता है, और कारण हो तो उसके साथ। तुरंत नहीं, बल्कि कुछ मिनट बाद अपने AI से फिर से जाँचने को कहें।
आम गड़बड़ियाँ
- कुछ दिखा नहीं तो दोबारा पब्लिश करना। पहली कॉल ने केवल टास्क शुरू किया था, इसलिए पोस्ट दोबारा भेजने से पहले उसका स्टेटस जाँचें।
- बिना post_ids के PUBLISH_COMPLETE को गड़बड़ी मानना। ID आने में तीन मिनट तक और लग सकते हैं, इसलिए तब फिर से जाँचें।
- फ़ॉर्मैट फ़ेल होने पर उसी फ़ाइल से दोबारा कोशिश करना। file_format_check_failed और बाकी जाँच की विफलताओं के लिए सुधरी हुई फ़ाइल चाहिए।
- डाउनलोड के दौरान यूआरएल बंद कर देना। TikTok फ़ाइल नहीं ला पाता तो पोस्ट को video_pull_failed या photo_pull_failed के साथ फ़ेल कर देता है।
US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, कनेक्शन जोड़ने पर घटती कीमत, पहले 3 दिन निःशुल्क।
अक्सर पूछे जाने वाले सवाल
TikTok पर share_id क्या है?
पब्लिशिंग टास्क की ID, जो वीडियो और फ़ोटो पब्लिश एंडपॉइंट लौटाते हैं। यह स्टेटस कॉल में publish_id के रूप में जाता है।
क्या TikTok पब्लिश स्टेटस के लिए वेबहुक है?
हाँ। event_type VIDEO के साथ /business/webhook/update/ के ज़रिए सब्सक्राइब किया गया ऐप TikTok की पोस्ट पब्लिशिंग इवेंट पाता है, जैसे post.publish.failed, उसके reason और publish_id के साथ, बार-बार स्टेटस जाँचने के बजाय।
पब्लिश हो चुकी पोस्ट की पोस्ट ID अभी क्यों नहीं है?
PUBLISH_COMPLETE के बाद post_ids लौटाने में TikTok को तीन मिनट तक लग सकते हैं, और वह केवल सार्वजनिक रूप से दिखने वाली पोस्ट के लिए ही लौटाता है।
क्या फ़ेल हुई TikTok पोस्ट दोबारा भेजी जा सकती है?
कारण पर निर्भर करता है। डाउनलोड और internal विफलताओं में दोबारा कोशिश हो सकती है; फ़ॉर्मैट, अवधि, फ़्रेम रेट और चित्र आकार की विफलताओं के लिए सुधरी हुई फ़ाइल चाहिए।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित