Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

video.upload

Zakres, który TikTok opisuje jako udostępnianie treści na konto twórcy jako szkic do dalszej edycji i publikacji w TikToku.

5 pending

Najwięcej oczekujących udostępnień, jakie Content Posting API dopuszcza w dowolnym 24-godzinnym okresie; limit ustawia TikTok, by ograniczyć spam.

SEND_TO_USER_INBOX

Status /business/publish/status/ informuje, gdy szkic zostanie przesłany i TikTok powiadomi skrzynkę twórcy.

6 a minute

Żądania, jakie każdy token dostępu użytkownika może wysłać do endpointu przesyłania Content Posting API.

Ignored

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 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

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:

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/

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_share z HTTP 403.
  • Żądania: 6 na minutę na token dostępu użytkownika, potem rate_limit_exceeded z HTTP 429.
  • Zakres: token bez video.upload dostaje scope_not_authorized z HTTP 401.
  • Media: PULL_FROM_URL z domeny lub prefiksu, którego aplikacja nie zweryfikowała, zwraca url_ownership_unverified z 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:

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
    }
  }'

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.
Z EasyCoexistence zrobisz to

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