Wysyłanie wideo do szkiców twórcy TikToka przez API
Interfejsy API TikToka wysyłają wideo do szkiców twórcy przez przepływ przesyłania: /v2/post/publish/inbox/video/init/ w Content Posting API przesyła je w zakresie video.upload, a TikTok wysyła twórcy powiadomienie w skrzynce, by mógł edytować i opublikować wideo w aplikacji. API for Business robi to samo za pomocą upload_to_draft na /business/video/publish/ lub is_draft w postach ze zdjęciami.
easyCoexistence publikuje wideo i posty ze zdjęciami w TikToku za pomocą publish_tiktok_post z Claude, ChatGPT lub własnej platformy, od razu albo w wybranym dniu i godzinie do 90 dni wcześniej, a każdy zakolejkowany post widać na ekranie Posty, aż wyjdzie.
Zakres, który TikTok opisuje jako udostępnianie treści na konto twórcy jako szkic do dalszej edycji i publikacji w TikToku.
Najwięcej oczekujących udostępnień, jakie Content Posting API dopuszcza w dowolnym 24-godzinnym okresie; limit ustawia TikTok, by ograniczyć spam.
Status /business/publish/status/ informuje, gdy szkic zostanie przesłany i TikTok powiadomi skrzynkę twórcy.
Żądania, jakie każdy token dostępu użytkownika może wysłać do endpointu przesyłania Content Posting API.
Co dzieje się z pozostałymi polami post_info, gdy upload_to_draft ma wartość true w /business/video/publish/.
Czym szkic różni się od bezpośredniego posta?
W tym, kto naciska Opublikuj. Bezpośredni post trafia na żywo, gdy TikTok go przetworzy; szkic trafia do skrzynki TikToka twórcy i zostaje opublikowany dopiero wtedy, gdy twórca go otworzy, edytuje według swoich potrzeb i opublikuje. Różnica dotyczy obu interfejsów publikacji TikToka:
| 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 |
Jak Content Posting API przesyła szkic?
Żądaniem POST na https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, z tokenem dostępu użytkownika z zakresem video.upload i obiektem source_info. PULL_FROM_URL każe TikTokowi pobrać wideo z domeny lub prefiksu URL, który aplikacja zweryfikowała; FILE_UPLOAD zwraca upload_url, a plik wysyła się pod ten adres w częściach, żądaniami PUT. Zwrócone publish_id trafia do /v2/post/publish/status/fetch/, zdjęcia korzystają z /v2/post/publish/content/init/ z post_mode ustawionym na MEDIA_UPLOAD, a TikTok prosi aplikacje, by poinformowały użytkowników, żeby otworzyli powiadomienie w skrzynce i kontynuowali edycję w TikToku:
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/Które limity dotyczą szkiców w Content Posting API?
TikTok opisuje je w swojej dokumentacji przesyłania; każdy z nich zwraca wywołanie init, gdy ma zastosowanie:
- Oczekujące udostępnienia: najwyżej 5 w dowolnym 24-godzinnym okresie; ponad ten limit zwracane jest
spam_risk_too_many_pending_sharez HTTP 403. - Żądania: 6 na minutę na token dostępu użytkownika, potem
rate_limit_exceededz HTTP 429. - Zakres: token bez video.upload dostaje
scope_not_authorizedz HTTP 401. - Media:
PULL_FROM_URLz domeny lub prefiksu, którego aplikacja nie zweryfikowała, zwracaurl_ownership_unverifiedz HTTP 403.
Jak API for Business przesyła szkic?
Przez swoje endpointy publikacji i jedno dodatkowe pole w post_info. Na /business/video/publish/ ustawienie upload_to_draft na true wysyła wideo jako szkic, a TikTok ignoruje pozostałe pola post_info; na /business/photo/publish/ is_draft zachowuje tylko tytuł i podpis. Oba wymagają video.upload w tokenie konta, który zwraca /tt_user/token_info/get/; bez niego właściciel zatwierdza przesyłanie szkiców, autoryzując aplikację ponownie. Media nadal muszą leżeć pod zweryfikowanym URL, status pokazuje SEND_TO_USER_INBOX, a twórca znajduje szkic dzięki powiadomieniu w skrzynce:
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
}
}'Co twórca robi ze szkicem?
Dokańcza go w TikToku. Powiadomienie w skrzynce otwiera przesłane wideo lub zdjęcia w edytorze TikToka, gdzie twórca je sprawdza, edytuje i publikuje. W Content Posting API status przechodzi z SEND_TO_USER_INBOX na PUBLISH_COMPLETE, gdy twórca opublikuje szkic, a TikTok zaznacza, że z jednego szkicu może powstać więcej niż jeden post.
Czy easyCoexistence wysyła szkice?
Nie: publish_tiktok_post publikuje. Wywołuje /business/video/publish/ lub /business/photo/publish/ bez upload_to_draft ani is_draft, więc post trafia na żywo, gdy TikTok go przetworzy. Aby wstrzymać post do przeglądu, zaplanuj go przez scheduled_at, od 1 minuty do 90 dni wcześniej: czeka w sekcji Coming up na ekranie Posty, update_scheduled_post zmienia jego czas, podpis lub tytuł posta ze zdjęciem, a cancel_scheduled_post zatrzymuje go przed wysłaniem.
Typowe błędy
- Proszenie o video.publish, by wysyłać szkice. Szkice wymagają video.upload, zakresu, który TikTok opisuje jako udostępnianie treści jako szkic.
- Ustawianie podpisu na szkicu wideo przez API for Business. Przy upload_to_draft ustawionym na true TikTok ignoruje resztę post_info.
- Przesyłanie szkiców szybciej, niż twórcy je publikują. Content Posting API zatrzymuje się na 5 oczekujących udostępnieniach w ciągu 24 godzin, z odpowiedzią spam_risk_too_many_pending_share.
- Zostawianie użytkowników bez wskazówki, gdzie szukać skrzynki. TikTok prosi aplikacje, by kazały im otworzyć powiadomienie w skrzynce i dokończyć post.
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, im więcej połączeń, tym taniej, z pierwszymi 3 dniami za darmo.
Najczęściej zadawane pytania
Czy API TikToka może zapisać wideo jako szkic?
Tak. Przepływ przesyłania umieszcza je w skrzynce TikToka twórcy, gdzie twórca je edytuje i publikuje; token potrzebuje zakresu video.upload.
Gdzie pojawia się szkic wysłany przez API?
W aplikacji TikTok, za powiadomieniem w skrzynce, które otwiera wideo w edytorze TikToka, by twórca dokończył post.
Czy szkic TikToka może zachować mój podpis?
W API for Business szkic zdjęcia zachowuje tytuł i podpis, a szkic wideo pomija pozostałe pola post_info.
Czy jeden szkic TikToka może stać się więcej niż jednym postem?
Tak. TikTok zaznacza, że z jednego szkicu może powstać więcej niż jeden post, a w Content Posting API status przechodzi na PUBLISH_COMPLETE, gdy twórca opublikuje z niego post.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w