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

Πώς ελέγχετε την κατάσταση δημοσίευσης μιας ανάρτησης στο TikTok μέσω του API

Το TikTok δημοσιεύει ασύγχρονα τις αναρτήσεις που στέλνονται μέσω του API: η κλήση δημοσίευσης επιστρέφει ένα share_id, και το GET /business/publish/status/ με αυτό το ID ως publish_id δείχνει πού βρίσκεται η ανάρτηση. Η κατάσταση είναι PROCESSING_DOWNLOAD όσο το TikTok κατεβάζει το αρχείο, PUBLISH_COMPLETE όταν η ανάρτηση έχει περάσει τον έλεγχο και έχει δημοσιευθεί, ή FAILED με αιτία, όπως frame_rate_check_failed.

Το easyCoexistence δημοσιεύει στο TikTok με το publish_tiktok_post και παρακολουθεί κάθε ανάρτηση με το get_tiktok_publish_status, από το Claude, το ChatGPT ή τον δικό σας κώδικα, ώστε το AI σας να βλέπει την κατάσταση του TikTok και την τυχόν αιτία αποτυχίας όπως είναι τη δεδομένη στιγμή.

3 min

Πόσο μπορεί να αργήσουν τα post IDs μετά το PUBLISH_COMPLETE, με το TikTok να προτείνει επανάληψη μετά από τρία λεπτά αν λείπουν.

30 min

Η γενική εκτίμηση του TikTok για τη λήψη ενός αρχείου ανάρτησης 1 GB, με τον πραγματικό χρόνο να εξαρτάται από το μέγεθος και το δίκτυο.

2 min

Ο συνηθισμένος μέγιστος χρόνος αναμονής, μετά την ολοκλήρωση του ανεβάσματος, για να γίνει δημόσια μια ανάρτηση. Ο χειροκίνητος έλεγχος μπορεί να διαρκέσει περισσότερο.

1 hour

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

Γιατί χρειάζεται παρακολούθηση μιας ανάρτησης στο TikTok;

Επειδή το TikTok τη δημοσιεύει στο παρασκήνιο. Η κλήση δημοσίευσης ξεκινά μια εργασία και επιστρέφει αμέσως ένα share_id· στη συνέχεια το TikTok κατεβάζει το αρχείο από το URL του, ελέγχει τη μορφή, εκτελεί τον έλεγχο και κάνει την ανάρτηση δημόσια. Μια ανάρτηση μπορεί να αποτύχει ακόμη και αφού η ίδια η κλήση έχει ολοκληρωθεί επιτυχώς.

Ποιες καταστάσεις υπάρχουν;

Το GET /business/publish/status/ δέχεται το business_id του λογαριασμού και το share_id ως publish_id, και επιστρέφει μία από τέσσερις καταστάσεις:

  • PROCESSING_DOWNLOAD: το TikTok κατεβάζει το περιεχόμενο από το URL του.
  • PUBLISH_COMPLETE: η ανάρτηση έχει περάσει τον έλεγχο και έχει δημοσιευθεί, και το post_ids την περιλαμβάνει μόλις γίνει δημόσια ορατή.
  • FAILED: η δημοσίευση σταμάτησε, και το reason εξηγεί γιατί.
  • SEND_TO_USER_INBOX: ένα προσχέδιο ανέβηκε και το TikTok ειδοποίησε τα εισερχόμενα του δημιουργού. Ισχύει μόνο για προσχέδια.

Πόσο διαρκεί η δημοσίευση;

Το TikTok δεν δίνει σταθερό χρόνο. Η λήψη εξαρτάται από το μέγεθος του αρχείου και το δίκτυο, και η γενική εκτίμηση του TikTok είναι ότι 30 λεπτά αρκούν για αρχείο 1 GB, με μία ώρα ως όριο. Μετά από αυτό, μια ανάρτηση συνήθως γίνεται δημόσια μέσα σε 2 λεπτά, ή αργότερα όταν χρειάζεται χειροκίνητο έλεγχο, και το post 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 δεν μπόρεσε να κατεβάσει το αρχείο, ή δεν το κατάφερε μέσα στην ώρα. Επανάληψη όταν το URL είναι δημόσια προσβάσιμο.
  • internal: μέρος της υπηρεσίας του TikTok ήταν μη διαθέσιμο, και η επανάληψη είναι εντάξει.
  • spam_risk_too_many_posts, spam_risk, spam_risk_text: το TikTok σταμάτησε την ανάρτηση λόγω όγκου, συμπεριφοράς ή περιεχομένου της λεζάντας.
  • auth_removed: ο λογαριασμός ανακάλεσε την πρόσβαση της εφαρμογής κατά την επεξεργασία, και το TikTok λέει να μην γίνει επανάληψη.
  • spam_risk_user_banned_from_posting: ο λογαριασμός έχει αποκλειστεί από τη δημοσίευση νέων αναρτήσεων.

Σε τι χρησιμεύει το post ID;

Για να βρίσκετε την ανάρτηση αργότερα. Η τεκμηρίωση του TikTok περνά τα post IDs στο /business/video/list/ στο filters.video_ids, για να διαβάσετε τα στατιστικά των αναρτήσεων. Οι κλήσεις σχολίων, από την πλευρά τους, παίρνουν το item_id μιας ανάρτησης από τη λίστα βίντεο του λογαριασμού ως video_id, και αυτό είναι που παίρνουν και τα εργαλεία σχολίων του easyCoexistence ως post_id.

Πώς το easyCoexistence παρακολουθεί μια ανάρτηση;

Το publish_tiktok_post επιστρέφει το share_id του TikTok με σημείωση ότι το TikTok επεξεργάζεται την ανάρτηση, και το get_tiktok_publish_status παίρνει αυτό το share_id και επιστρέφει την τρέχουσα κατάσταση του TikTok, με την αιτία όταν υπάρχει. Ζητήστε από το AI σας να ελέγξει ξανά μετά από μερικά λεπτά και όχι αμέσως.

Συνηθισμένα λάθη

  • Νέα δημοσίευση επειδή δεν φάνηκε τίποτα ακόμη. Η πρώτη κλήση απλώς ξεκίνησε την εργασία, οπότε ελέγξτε την κατάστασή της πριν στείλετε ξανά την ανάρτηση.
  • Η αντιμετώπιση του PUBLISH_COMPLETE χωρίς post_ids ως σφάλμα. Τα IDs μπορεί να αργήσουν έως τρία λεπτά ακόμη, οπότε ελέγξτε ξανά τότε.
  • Επανάληψη αποτυχίας μορφής με το ίδιο αρχείο. Τα file_format_check_failed και οι υπόλοιπες αποτυχίες ελέγχου χρειάζονται διορθωμένο αρχείο.
  • Αφαίρεση του URL εκτός σύνδεσης κατά τη λήψη. Το TikTok αποτυγχάνει την ανάρτηση με video_pull_failed ή photo_pull_failed όταν δεν μπορεί να φέρει το αρχείο.
Κάντε το με EasyCoexistence

US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση καθώς προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Τι είναι το share_id στο TikTok;

Το ID μιας εργασίας δημοσίευσης, που επιστρέφουν τα endpoints δημοσίευσης βίντεο και φωτογραφιών. Μπαίνει στην κλήση κατάστασης ως publish_id.

Υπάρχει ένα webhook για την κατάσταση δημοσίευσης στο TikTok;

Ναι. Μια εφαρμογή που έχει εγγραφεί με event_type VIDEO μέσω του /business/webhook/update/ λαμβάνει τα συμβάντα δημοσίευσης αναρτήσεων του TikTok, όπως το post.publish.failed με την αιτία και το publish_id, αντί για επαναλαμβανόμενους ελέγχους κατάστασης.

Γιατί μια δημοσιευμένη ανάρτηση δεν έχει ακόμη post ID;

Το TikTok μπορεί να χρειαστεί έως τρία λεπτά μετά το PUBLISH_COMPLETE για να επιστρέψει τα post_ids, και τα επιστρέφει μόνο για αναρτήσεις που είναι δημόσια ορατές.

Μπορεί να γίνει επανάληψη μιας αποτυχημένης ανάρτησης στο TikTok;

Ανάλογα με την αιτία. Οι αποτυχίες λήψης και οι εσωτερικές μπορούν να επαναληφθούν· οι αποτυχίες μορφής, διάρκειας, ρυθμού καρέ και μεγέθους εικόνας χρειάζονται διορθωμένο αρχείο.

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

Απαιτήσεις βίντεο TikTok για το API: μορφή, μέγεθος και διάρκειαΤα βίντεο που δημοσιεύει το API for Business του TikTok: MP4, MOV ή WebM, 3 έως 600 δευτερόλεπτα, έως 1 GB, 23 έως 60 FPS, από URL που κατεβάζει το TikTok.Όρια δημοσίευσης του TikTok API: πόσες αναρτήσεις ανά ημέραΠόσες αναρτήσεις δημοσιεύει το API του TikTok ανά λογαριασμό: έξι το λεπτό και 15 την ημέρα, και τι γίνεται πέρα από το όριο.Προγραμματισμός αναρτήσεων TikTok μέσω του APIΠώς προγραμματίζονται βίντεο και φωτογραφίες TikTok μέσω του API: μια ουρά δημοσιεύει στην ώρα που ορίζετε, με τους κανόνες του TikTok.Συμβάντα webhook σχολίων της TikTokΠώς το webhook comment.update της TikTok αναφέρει σχόλια και απαντήσεις, τι περιέχει κάθε συμβάν και πώς φτάνει υπογεγραμμένο στο endpoint σας.TikTok Analytics API: μετρήσεις λογαριασμού και βίντεοΟι μετρήσεις TikTok του API for Business: ακόλουθοι, προβολές και likes ανά ημέρα για λογαριασμό, και προβολές, likes, σχόλια και κοινοποιήσεις ανά βίντεο.Σφάλμα TikTok 40007: το αντικείμενο δεν υπάρχειΤο σφάλμα TikTok 40007 σημαίνει ότι το αίτημα αναφέρεται σε αντικείμενο, URL ή αρχείο που δεν υπάρχει. Ελέγξτε τα ID του Accounts API και την προέλευσή τους.

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

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

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

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