ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Αποτυχίες δημοσίευσης στο 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

Το πεδίο reason του /business/publish/status/ επιστρέφεται μόνο όταν η κατάσταση είναι FAILED, με τιμές όπως frame_rate_check_failed.

fail_reason

Το όνομα που έχει το ίδιο πεδίο στο Content Posting API, στις απαντήσεις του /v2/post/publish/status/fetch/.

1 hour

Χρονικό όριο λήψης, μετά το οποίο το TikTok αποτυγχάνει μια ανάρτηση με video_pull_failed ή photo_pull_failed.

24 hours

Χρονικό παράθυρο πίσω από το spam_risk_too_many_posts. Το TikTok προτείνει να δημοσιεύσετε εκείνη την ανάρτηση από την εφαρμογή του κινητού.

3 hours

Συνήθως το 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.

A failed post in /business/publish/status/, from TikTok's example
{
  "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 foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing 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 μόνο αν η ανάρτηση λείπει. Μια ανάρτηση που χρειάζεται νέο αρχείο ή λεζάντα προγραμματίζεται ξανά.

Failed posts through MCP
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.
Κάντε το με EasyCoexistence

Μια αποτυχία φτάνει με τον λόγο του 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 την στέλνει ξανά.

Συνεχίστε την ανάγνωση

Πώς ελέγχετε την κατάσταση δημοσίευσης μιας ανάρτησης στο TikTok μέσω του APIΠώς παρακολουθείτε ανάρτηση στο TikTok που δημοσιεύεται μέσω του API: share_id, PROCESSING_DOWNLOAD, PUBLISH_COMPLETE, FAILED, τα post IDs και αιτίες αποτυχίας.Όρια δημοσίευσης του TikTok API: πόσες αναρτήσεις ανά ημέραΠόσες αναρτήσεις δημοσιεύει το API του TikTok ανά λογαριασμό: έξι το λεπτό και 15 την ημέρα, και τι γίνεται πέρα από το όριο.TikTok media URLs: επαληθευμένα domains και URL prefixesΠώς το API for Business του TikTok λαμβάνει τα media από επαληθευμένα domains και URL prefixes, με έλεγχο DNS TXT ή αρχείου υπογραφής.Φωτογραφικές αναρτήσεις και καρουζέλ TikTok μέσω του API: έως 35 εικόνεςΤο API for Business του TikTok δημοσιεύει φωτογραφικές αναρτήσεις: 1 έως 35 εικόνες JPEG ή WebP έως 20 MB η καθεμία, τίτλο 90 χαρακτήρων, λεζάντα, εξώφυλλο.Αποστολή βίντεο στα πρόχειρα ενός δημιουργού μέσω του APIΠώς τα API του TikTok στέλνουν βίντεο στα πρόχειρα του δημιουργού: η ροή upload του Content Posting API, upload_to_draft, is_draft και το scope video.upload.Γιατί οι αναρτήσεις του TikTok API είναι ιδιωτικές: unaudited_client_can_only_post_to_private_accountsΓιατί το Content Posting API κρατά τις αναρτήσεις ιδιωτικές έως τον έλεγχο της εφαρμογής, τι σημαίνει το 403 και πώς διαφέρει το API for Business.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις