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

Αποστολή βίντεο στα πρόχειρα ενός δημιουργού μέσω του 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 μέχρι να βγει.

video.upload

Το scope που ορίζει το TikTok για την κοινοποίηση περιεχομένου στον λογαριασμό του δημιουργού ως πρόχειρο, για περαιτέρω επεξεργασία και ανάρτηση στο TikTok.

5 pending

Ο μέγιστος αριθμός εκκρεμών κοινοποιήσεων που επιτρέπει το Content Posting API σε οποιαδήποτε περίοδο 24 ωρών, όριο που θέτει το TikTok για τη μείωση του spam.

SEND_TO_USER_INBOX

Η κατάσταση /business/publish/status/ αναφέρει πότε ένα πρόχειρο έχει ανέβει και το TikTok έχει ειδοποιήσει τα εισερχόμενα του δημιουργού.

6 a minute

Τα αιτήματα που μπορεί να στείλει κάθε user access token στο endpoint upload του Content Posting API.

Ignored

Τι συμβαίνει με τα υπόλοιπα πεδία του post_info όταν το upload_to_draft είναι true στο /business/video/publish/.

Πώς διαφέρει ένα πρόχειρο από μια άμεση ανάρτηση;

Στο ποιος πατά το Post. Μια άμεση ανάρτηση δημοσιεύεται μόλις την επεξεργαστεί το TikTok, ενώ ένα πρόχειρο πέφτει στα εισερχόμενα του δημιουργού στο TikTok και δημοσιεύεται μόνο όταν ο δημιουργός το ανοίξει, το επεξεργαστεί όπως θέλει και το αναρτήσει. Η διαφορά διαπερνά και τα δύο API δημοσίευσης του TikTok:

Draft (upload)Direct post
Who postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent 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:

Upload a video to the creator's inbox from a URL
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, και ο δημιουργός βρίσκει το πρόχειρο μέσω της ειδοποίησης των εισερχομένων:

Send a video to the creator's drafts on the API for Business
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 ζητά από τις εφαρμογές να τους πουν να ανοίξουν την ειδοποίηση των εισερχομένων για να ολοκληρώσουν την ανάρτηση.
Κάντε το με EasyCoexistence

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 μόλις ο δημιουργός αναρτήσει από αυτό.

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

Ρυθμίσεις ανάρτησης TikTok μέσω API: ιδιωτικότητα, σχόλια, Duet και StitchΟι ρυθμίσεις των endpoints δημοσίευσης του TikTok: ιδιωτικότητα, σχόλια, Duet, Stitch, εξώφυλλο, ετικέτες AI και επωνυμίας.Πώς ελέγχετε την κατάσταση δημοσίευσης μιας ανάρτησης στο TikTok μέσω του APIΠώς παρακολουθείτε ανάρτηση στο TikTok που δημοσιεύεται μέσω του API: share_id, PROCESSING_DOWNLOAD, PUBLISH_COMPLETE, FAILED, τα post IDs και αιτίες αποτυχίας.Γιατί οι αναρτήσεις του TikTok API είναι ιδιωτικές: unaudited_client_can_only_post_to_private_accountsΓιατί το Content Posting API κρατά τις αναρτήσεις ιδιωτικές έως τον έλεγχο της εφαρμογής, τι σημαίνει το 403 και πώς διαφέρει το API for Business.Πώς να ανεβάσετε βίντεο στο TikTok μέσω του APIΑνεβάστε βίντεο στο TikTok με το API for Business: το publish endpoint, το JSON body, το share_id και την κλήση status, σε curl και Python.TikTok media URLs: επαληθευμένα domains και URL prefixesΠώς το API for Business του TikTok λαμβάνει τα media από επαληθευμένα domains και URL prefixes, με έλεγχο DNS TXT ή αρχείου υπογραφής.Αποτυχίες δημοσίευσης στο TikTok: spam_risk_too_many_posts, picture_size_check_failed και άλλοι λόγοι αποτυχίαςΤι σημαίνουν οι λόγοι αποτυχίας του TikTok και πώς διορθώνονται: spam_risk_too_many_posts, picture_size_check_failed, video_pull_failed κ.ά.

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

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

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

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