Αποστολή βίντεο στα πρόχειρα ενός δημιουργού μέσω του API
Τα API του TikTok στέλνουν βίντεο στα πρόχειρα ενός δημιουργού μέσω της ροής upload: το /v2/post/publish/inbox/video/init/ του Content Posting API το ανεβάζει με το scope video.upload, και το TikTok στέλνει στον δημιουργό μια ειδοποίηση στα εισερχόμενα για να το επεξεργαστεί και να το αναρτήσει στην εφαρμογή. Το API for Business κάνει το ίδιο με το upload_to_draft στο /business/video/publish/, ή με το is_draft στις φωτογραφικές αναρτήσεις.
Το easyCoexistence δημοσιεύει βίντεο και φωτογραφικές αναρτήσεις στο TikTok με το publish_tiktok_post, από το Claude, το ChatGPT ή τη δική σας πλατφόρμα, τώρα ή σε ημερομηνία και ώρα έως 90 ημέρες μπροστά, με κάθε αναμονή στην οθόνη Posts μέχρι να βγει.
Το scope που ορίζει το TikTok για την κοινοποίηση περιεχομένου στον λογαριασμό του δημιουργού ως πρόχειρο, για περαιτέρω επεξεργασία και ανάρτηση στο TikTok.
Ο μέγιστος αριθμός εκκρεμών κοινοποιήσεων που επιτρέπει το Content Posting API σε οποιαδήποτε περίοδο 24 ωρών, όριο που θέτει το TikTok για τη μείωση του spam.
Η κατάσταση /business/publish/status/ αναφέρει πότε ένα πρόχειρο έχει ανέβει και το TikTok έχει ειδοποιήσει τα εισερχόμενα του δημιουργού.
Τα αιτήματα που μπορεί να στείλει κάθε user access token στο endpoint upload του Content Posting API.
Τι συμβαίνει με τα υπόλοιπα πεδία του post_info όταν το upload_to_draft είναι true στο /business/video/publish/.
Πώς διαφέρει ένα πρόχειρο από μια άμεση ανάρτηση;
Στο ποιος πατά το Post. Μια άμεση ανάρτηση δημοσιεύεται μόλις την επεξεργαστεί το TikTok, ενώ ένα πρόχειρο πέφτει στα εισερχόμενα του δημιουργού στο TikTok και δημοσιεύεται μόνο όταν ο δημιουργός το ανοίξει, το επεξεργαστεί όπως θέλει και το αναρτήσει. Η διαφορά διαπερνά και τα δύο API δημοσίευσης του TikTok:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Πώς ανεβάζει ένα πρόχειρο το Content Posting API;
Με POST στο https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, με user access token που έχει το video.upload και ένα αντικείμενο source_info. Το PULL_FROM_URL ζητά από το TikTok να τραβήξει το βίντεο από ένα domain ή prefix URL που έχει επαληθεύσει η εφαρμογή· το FILE_UPLOAD επιστρέφει ένα upload_url, στο οποίο το αρχείο στέλνεται σε κομμάτια με αιτήματα PUT. Το publish_id που επιστρέφεται πηγαίνει στο /v2/post/publish/status/fetch/, οι φωτογραφίες χρησιμοποιούν το /v2/post/publish/content/init/ με post_mode ορισμένο σε MEDIA_UPLOAD, και το TikTok ζητά από τις εφαρμογές να λένε στους χρήστες να ανοίξουν την ειδοποίηση των εισερχομένων για να συνεχίσουν την επεξεργασία στο TikTok:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Ποια όρια ισχύουν για τα πρόχειρα του Content Posting API;
Τα τεκμηριώνει το TikTok στην αναφορά upload του, και κάθε ένα επιστρέφεται από την κλήση init όταν ισχύει:
- Εκκρεμή πρόχειρα: το πολύ 5 εκκρεμείς κοινοποιήσεις σε οποιαδήποτε περίοδο 24 ωρών· πέραν αυτού,
spam_risk_too_many_pending_shareμε HTTP 403. - Αιτήματα: 6 το λεπτό ανά user access token, και μετά
rate_limit_exceededμε HTTP 429. - Scope: ένα token χωρίς video.upload παίρνει
scope_not_authorizedμε HTTP 401. - Πολυμέσα: το
PULL_FROM_URLαπό domain ή prefix που δεν έχει επαληθεύσει η εφαρμογή παίρνειurl_ownership_unverifiedμε HTTP 403.
Πώς ανεβάζει ένα πρόχειρο το API for Business;
Με τα endpoints δημοσίευσης του και ένα ακόμα πεδίο στο post_info. Στο /business/video/publish/, το upload_to_draft ορισμένο σε true στέλνει το βίντεο ως πρόχειρο, και το TikTok αγνοεί τα υπόλοιπα πεδία του post_info· στο /business/photo/publish/, το is_draft κρατά μόνο τον τίτλο και τη λεζάντα. Και τα δύο χρειάζονται video.upload στο token του λογαριασμού, το οποίο εμφανίζει το /tt_user/token_info/get/, και χωρίς αυτό ο ιδιοκτήτης εγκρίνει ξανά το ανέβασμα πρόχειρων εξουσιοδοτώντας την εφαρμογή. Τα πολυμέσα παραμένουν σε επαληθευμένο URL, η κατάσταση γράφει SEND_TO_USER_INBOX, και ο δημιουργός βρίσκει το πρόχειρο μέσω της ειδοποίησης των εισερχομένων:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'Τι κάνει ο δημιουργός με το πρόχειρο;
Το ολοκληρώνει στο TikTok. Η ειδοποίηση των εισερχομένων ανοίγει τα ανεβασμένα βίντεο ή φωτογραφίες στον επεξεργαστή του TikTok, όπου ο δημιουργός τα ελέγχει, τα επεξεργάζεται και τα αναρτά. Στο Content Posting API, η κατάσταση περνά από SEND_TO_USER_INBOX σε PUBLISH_COMPLETE μόλις ο δημιουργός αναρτήσει από το πρόχειρο, και το TikTok σημειώνει ότι ένα πρόχειρο μπορεί να παράγει περισσότερες από μία αναρτήσεις.
Στέλνει πρόχειρα το easyCoexistence;
Όχι: το publish_tiktok_post δημοσιεύει. Καλεί το /business/video/publish/ ή το /business/photo/publish/ χωρίς upload_to_draft ή is_draft, οπότε μια ανάρτηση δημοσιεύεται μόλις την επεξεργαστεί το TikTok. Για να κρατήσετε μια ανάρτηση για έλεγχο, προγραμματίστε την με scheduled_at, από 1 λεπτό έως 90 ημέρες μπροστά: περιμένει στο Coming up της οθόνης Posts, το update_scheduled_post αλλάζει την ώρα της, τη λεζάντα της ή τον τίτλο μιας φωτογραφικής ανάρτησης, και το cancel_scheduled_post τη σταματά πριν βγει.
Συνηθισμένα λάθη
- Ζητάτε το video.publish για να στέλνετε πρόχειρα. Τα πρόχειρα χρειάζονται video.upload, το scope που περιγράφει το TikTok ως κοινοποίηση περιεχομένου ως πρόχειρο.
- Ορίζετε λεζάντα σε πρόχειρο βίντεο μέσω του API for Business. Με upload_to_draft ορισμένο σε true, το TikTok αγνοεί το υπόλοιπο post_info.
- Ανεβάζετε πρόχειρα πιο γρήγορα από ό,τι τα αναρτούν οι δημιουργοί. Το Content Posting API σταματά στις 5 εκκρεμείς κοινοποιήσεις σε 24 ώρες με spam_risk_too_many_pending_share.
- Αφήνετε τους χρήστες χωρίς οδηγία προς τα εισερχόμενα. Το TikTok ζητά από τις εφαρμογές να τους πουν να ανοίξουν την ειδοποίηση των εισερχομένων για να ολοκληρώσουν την ανάρτηση.
US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με πτώση καθώς προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Μπορεί το API του TikTok να αποθηκεύσει ένα βίντεο ως πρόχειρο;
Ναι. Η ροή upload το βάζει στα εισερχόμενα του δημιουργού στο TikTok, όπου ο δημιουργός το επεξεργάζεται και το αναρτά· το token χρειάζεται το scope video.upload.
Πού εμφανίζεται ένα πρόχειρο που στάλθηκε μέσω του API;
Στην εφαρμογή TikTok, πίσω από μια ειδοποίηση των εισερχομένων που ανοίγει το βίντεο στον επεξεργαστή του TikTok για να το ολοκληρώσει ο δημιουργός.
Μπορεί ένα πρόχειρο στο TikTok να κρατήσει τη λεζάντα μου;
Στο API for Business, ένα πρόχειρο φωτογραφίας κρατά τον τίτλο και τη λεζάντα του, ενώ ένα πρόχειρο βίντεο αφαιρεί τα υπόλοιπα πεδία του post_info.
Μπορεί ένα πρόχειρο στο TikTok να γίνει περισσότερες από μία αναρτήσεις;
Ναι. Το TikTok σημειώνει ότι ένα πρόχειρο μπορεί να παράγει περισσότερες από μία αναρτήσεις, και στο Content Posting API η κατάσταση περνά σε PUBLISH_COMPLETE μόλις ο δημιουργός αναρτήσει από αυτό.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις