Αποτυχίες δημοσίευσης στο TikTok: spam_risk_too_many_posts, picture_size_check_failed και άλλοι λόγοι αποτυχίας
Το TikTok ονομάζει την αιτία μιας αποτυχημένης ανάρτησης στο πεδίο reason, στο endpoint κατάστασης του API for Business, ή στο πεδίο fail_reason του Content Posting API. Οι αποτυχίες ελέγχου, όπως το picture_size_check_failed, σημαίνουν ότι το αρχείο παραβιάζει κανόνα μορφής και πρέπει να αλλάξει. Το video_pull_failed σημαίνει ότι το TikTok δεν μπόρεσε να κατεβάσει το βίντεο μέσα σε μία ώρα. Το spam_risk_too_many_posts σημαίνει ότι υπάρχουν πάρα πολλές αναρτήσεις μέσω API μέσα σε 24 ώρες. Μια αποτυχία με σήμανση internal μπορεί απλώς να επαναληφθεί.
Το easyCoexistence παρακολουθεί κάθε ανάρτηση στο TikTok που δημοσιεύει, μέχρι το TikTok να την ολοκληρώσει ή να την αποτύχει, για το Claude, το ChatGPT ή τη δική σας πλατφόρμα.
Το πεδίο reason του /business/publish/status/ επιστρέφεται μόνο όταν η κατάσταση είναι FAILED, με τιμές όπως frame_rate_check_failed.
Το όνομα που έχει το ίδιο πεδίο στο Content Posting API, στις απαντήσεις του /v2/post/publish/status/fetch/.
Χρονικό όριο λήψης, μετά το οποίο το TikTok αποτυγχάνει μια ανάρτηση με video_pull_failed ή photo_pull_failed.
Χρονικό παράθυρο πίσω από το spam_risk_too_many_posts. Το TikTok προτείνει να δημοσιεύσετε εκείνη την ανάρτηση από την εφαρμογή του κινητού.
Συνήθως το easyCoexistence στέλνει email στον ιδιοκτήτη για αποτυχημένες αναρτήσεις σε ένα κανάλι. Η ανάρτηση περιμένει στην ενότητα «Χρειάζεται προσοχή».
Πού αναφέρει το TikTok τον λόγο αποτυχίας μιας ανάρτησης;
Μετά την κλήση δημοσίευσης, η οποία απλώς ξεκινά την εργασία: ο κωδικός 0 σημαίνει ότι το TikTok την αποδέχθηκε, όχι ότι η ανάρτηση θα δημοσιευτεί. Το GET /business/publish/status/ επιστρέφει τότε FAILED με το reason. Μια εφαρμογή που έχει εγγραφεί στα webhooks δημοσίευσης λαμβάνει το post.publish.failed με τον ίδιο λόγο και το publish_id. Το /v2/post/publish/status/fetch/ του Content Posting API επιστρέφει το πεδίο ως fail_reason.
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}Τι σημαίνει κάθε λόγος αποτυχίας και ποια διόρθωση χρειάζεται;
Οι λόγοι του TikTok, όπως τους περιγράφει η τεκμηρίωσή του για τα συμβάντα δημοσίευσης αναρτήσεων, δίπλα στη διόρθωση στην οποία παραπέμπει ο καθένας. Οι πρώτοι τέσσερις είναι έλεγχοι που εκτελεί το TikTok στο αρχείο αφού το κατεβάσει, και όλοι σημειώνονται ως μη επαναλήψιμοι. Ο πίνακας αποτυχιών του TikTok εξακολουθεί να δίνει 60 δευτερόλεπτα ως το μεγαλύτερο βίντεο για το duration_check_failed, ενώ το endpoint για βίντεο τεκμηριώνει 600, ή την τιμή max_video_post_duration_sec του ίδιου του λογαριασμού:
| What TikTok found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing again if the post is still wanted |
Ποιες αποτυχίες μπορούν να επαναληφθούν;
Εκείνες που προκλήθηκαν από τη λήψη ή από το ίδιο το TikTok. Οι υπόλοιπες χρειάζονται άλλο αρχείο ή λεζάντα, παύση, ή καμία ενέργεια:
- Επανάληψη χωρίς αλλαγές: internal, και
video_pull_failedήphoto_pull_failedόταν το URL είναι δημόσιο και αρκετά γρήγορο. - Επανάληψη με νέο αρχείο:
file_format_check_failed,duration_check_failed,frame_rate_check_failedκαιpicture_size_check_failed. - Επανάληψη με νέα λεζάντα:
spam_risk_text. - Αναμονή, ή ανάρτηση από την εφαρμογή TikTok:
spam_risk_too_many_posts. - Χωρίς επανάληψη:
auth_removedκαιspam_risk, όπως συμβουλεύει το TikTok, ήspam_risk_user_banned_from_posting.
Σε τι διαφέρουν οι αποτυχίες του Content Posting API;
Οι ίδιοι λόγοι, διαφορετικό πεδίο και endpoint, και αρνήσεις που έρχονται πριν ξεκινήσει η επεξεργασία. Το /v2/post/publish/status/fetch/ επιστρέφει το fail_reason, επιτρέπει 30 αιτήματα ανά λεπτό ανά token του χρήστη και προσθέτει οδηγίες μη επανάληψης για τα spam_risk_user_banned_from_posting και spam_risk_text. Ορισμένες αρνήσεις φτάνουν στην κλήση init, με HTTP 403:
spam_risk_too_many_posts: ο δημιουργός έφτασε το ημερήσιο ανώτατο όριο αναρτήσεων του API.unaudited_client_can_only_post_to_private_accounts: μια μη ελεγμένη εφαρμογή προσπάθησε να δημοσιεύσει για δημόσιο λογαριασμό.url_ownership_unverified:PULL_FROM_URLαπό έναν τομέα ή πρόθεμα που η εφαρμογή δεν έχει επαληθεύσει.privacy_level_option_mismatch: τοprivacy_levelλείπει ή βρίσκεται εκτός των επιλογών του δημιουργού.reached_active_user_cap: η εφαρμογή έφτασε το ημερήσιο όριο ενεργών χρηστών δημοσίευσης.
Τι αποτυγχάνει πριν φτάσει στο TikTok;
Αυτά που μπορεί να εντοπίσει πρώτο το easyCoexistence, με δικό του μήνυμα αντί για λόγο του TikTok. Το media μιας προγραμματισμένης ανάρτησης αντιγράφεται τη στιγμή του προγραμματισμού, και ένας σύνδεσμος που επιστρέφει ιστοσελίδα, 404, αρχείο λάθος τύπου ή αρχείο άνω των 30 MB για εικόνα ή 1 GB για βίντεο απορρίπτεται τότε. Οι σύνδεσμοι φωτογραφιών που τελειώνουν σε .png, .gif, .bmp, .heic, .avif ή .svg απορρίπτονται πριν σταλεί οτιδήποτε. Ένα κανάλι που χρειάζεται επανασύνδεση τη στιγμή της ανάρτησης αποτυγχάνει ως reconnect, και η αφαίρεση ενός καναλιού ακυρώνει τις προγραμματισμένες αναρτήσεις του.
Πώς αναφέρει το easyCoexistence μια αποτυχημένη ανάρτηση στο TikTok;
Μέσω της ουράς ανάρτησης, η οποία παρακολουθεί κάθε ανάρτηση στο TikTok μετά την κλήση δημοσίευσης, ελέγχοντας το /business/publish/status/ περίπου κάθε 20 δευτερόλεπτα έως ότου εμφανιστεί PUBLISH_COMPLETE. Μια κατάσταση FAILED αποτυγχάνει την ανάρτηση. Το μήνυμα σφάλματος αναφέρει τον λόγο του TikTok σε παρένθεση, όπως frame_rate_check_failed, και κάθε αποτυχία φέρει failure_kind:
- refused: το TikTok απάντησε αρνητικά, όπως στην κατάσταση FAILED και στον λόγο της.
- uncertain: η κλήση δημοσίευσης δεν πήρε καθαρή απάντηση, ή το TikTok δεν επιβεβαίωσε εντός 2 ωρών. Η ανάρτηση ίσως είναι ήδη ενεργή (
may_be_published). - reconnect: το TikTok απέρριψε το token του λογαριασμού, και ο λογαριασμός χρειάζεται νέα σύνδεση.
- internal: το easyCoexistence απέτυχε πριν παραδώσει την ανάρτηση, οπότε τίποτα δεν στάλθηκε.
Πώς βρίσκετε και επαναλαμβάνετε μια αποτυχημένη ανάρτηση;
Ο ιδιοκτήτης λαμβάνει email για αποτυχία που εντοπίστηκε στο παρασκήνιο, το πολύ ένα ανά κανάλι κάθε 3 ώρες, και η διεύθυνση συμβάντων μιας πλατφόρμας λαμβάνει το post.failed. Η ανάρτηση εμφανίζεται στο «Χρειάζεται προσοχή» της οθόνης Posts, με τις επιλογές Επανάληψη, Επανασύνδεση και Αγνόηση. Το list_scheduled_posts την επιστρέφει στο Claude ή στο ChatGPT. Το retry_scheduled_post τη δημοσιεύει ξανά, τώρα, από αρχεία που διατηρούνται 7 ημέρες μετά την αποτυχία. Όταν το may_be_published είναι true, ελέγξτε πρώτα το list_social_posts και δώστε confirm μόνο αν η ανάρτηση λείπει. Μια ανάρτηση που χρειάζεται νέο αρχείο ή λεζάντα προγραμματίζεται ξανά.
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }
retry_scheduled_post { "post_id": "<POST_ID>" }
// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }Συνηθισμένα λάθη
- Επανάληψη αποτυχίας ελέγχου με το ίδιο αρχείο. Το TikTok σημειώνει τις αποτυχίες μορφής, διάρκειας, ρυθμού καρέ και μεγέθους εικόνας ως μη επαναλήψιμες.
- Άμεση επανάληψη του spam_risk_too_many_posts. Το TikTok μετρά τις αναρτήσεις API σε 24 ώρες και προτείνει δημοσίευση από την εφαρμογή κινητού.
- Επανάληψη ανάρτησης με may_be_published χωρίς έλεγχο. Το TikTok ίσως τη δημοσίευσε ήδη. Ελέγξτε τις τελευταίες αναρτήσεις του λογαριασμού, αλλιώς θα βγει δύο φορές.
- Αναζήτηση του fail_reason στο API for Business. Το endpoint κατάστασής του ονομάζει το πεδίο reason, ενώ το fail_reason ανήκει στο Content Posting API.
Μια αποτυχία φτάνει με τον λόγο του TikTok μέσω email, στην οθόνη Posts και ως συμβάν post.failed, έτοιμη για επανάληψη. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με δωρεάν δοκιμή 3 ημερών.
Συχνές ερωτήσεις
Τι σημαίνει το picture_size_check_failed στο TikTok;
Το TikTok κατέβασε την ανάρτηση και βρήκε την εικόνα της κάτω από το ελάχιστο των 360 pixels σε ύψος και πλάτος. Χρειάζεται μεγαλύτερο αρχείο, αφού το TikTok σημειώνει την αποτυχία ως μη επαναλήψιμη.
Τι είναι το video_pull_failed;
Το TikTok δεν μπόρεσε να κατεβάσει το βίντεο από το URL του, ή δεν το κατάφερε μέσα στο χρονικό όριο μίας ώρας. Ελέγξτε ότι το URL είναι δημόσιο και δεν έχει περιορισμό εύρους ζώνης, και μετά επαναλάβετε.
Πόσο διαρκεί το spam_risk_too_many_posts;
Το TikTok μετρά τις αναρτήσεις που έγιναν μέσω του API τις τελευταίες 24 ώρες, περίπου 15 την ημέρα ανά λογαριασμό. Στο μεταξύ προτείνει δημοσίευση από την εφαρμογή κινητού του TikTok.
Επαναλαμβάνει το easyCoexistence μόνο του μια αποτυχημένη ανάρτηση στο TikTok;
Όχι, αφού το TikTok αναφέρει FAILED. Η ανάρτηση περιμένει στο «Χρειάζεται προσοχή», ο ιδιοκτήτης λαμβάνει email, και η επιλογή Επανάληψη ή το retry_scheduled_post την στέλνει ξανά.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις