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

Jak opublikować wideo na TikToku przez API

Aby opublikować wideo przez API for Business w TikToku, wyślij POST na /business/video/publish/ z business_id konta, video_url z domeny lub prefiksu adresu URL zweryfikowanego w TikToku oraz obiektem post_info z podpisem i ustawieniami, z nagłówkiem Access-Token. TikTok odpowiada share_id; przekaż go jako publish_id do /business/publish/status/, aż status przyjmie wartość PUBLISH_COMPLETE i pojawią się post_ids.

easyCoexistence publikuje wideo na TikToku za pomocą publish_tiktok_post z Claude, ChatGPT lub własnego agenta: podajesz link HTTPS, podpis i to, czy komentarze są włączone, a potem śledzisz post przez get_tiktok_publish_status, podczas gdy plik trafia do TikToka przez zweryfikowaną trasę mediów.

share_id

Zwracany przez wywołanie publikacji, na przykład v_pub_url~v1.2345123456789123456, i przekazywany do wywołania statusu jako publish_id.

Nov 16, 2023

Od tamtego czasu TikTok odrzuca publikację wideo z adresów URL, których domena lub prefiks nie jest zweryfikowany.

6 a minute

Limit TikToka na liczbę postów wideo na konto przez endpoint publikacji, najwyżej 15 dziennie.

3 min

Jak długo post_ids mogą się pojawiać po PUBLISH_COMPLETE; TikTok zaleca ponowić próbę po trzech minutach.

post_id

Wysyłany w webhooku post.publish.publicly_available, gdy post przejdzie moderację, gotowy do odpytania o jego statystyki.

Czego potrzebujesz przed pierwszym wywołaniem?

Trzech rzeczy. Tokenu dostępu konta TikTok oraz open_id konta, uzyskanych z wymiany tokenu; aplikacji deweloperskiej z uprawnieniem „Video Publish” w sekcji „TikTok Accounts”; oraz wideo pod publicznym adresem HTTPS lub HTTP, znajdującym się w domenie albo prefiksie URL zweryfikowanym dla aplikacji. TikTok sam pobiera plik, więc adres musi pozostać osiągalny, a TikTok zaleca adres ważny przynajmniej przez 30 minut.

Jak wygląda żądanie publikacji?

POST na https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, z tokenem konta w nagłówku Access-Token i Content-Type ustawionym na application/json. Treść JSON wskazuje konto w business_id, plik w video_url, a ustawienia posta w post_info. Ten przykład publikuje wideo z podpisem, z włączonymi komentarzami, Duet i Stitch:

Publish a video with curl
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/launch.mp4",
    "post_info": {
      "caption": "Our new menu is live #food",
      "is_brand_organic": false,
      "is_branded_content": false,
      "disable_comment": false,
      "disable_duet": false,
      "disable_stitch": false
    }
  }'

Co robi każde pole treści?

Pola, które dokumentacja TikToka wymienia dla posta wideo, od najwyższego poziomu. Okładka, etykieta wygenerowana przez AI, lokalizacja, szkice i opcja tylko dla reklam znajdują się w tej samej treści:

  • business_id: open_id konta z wymiany tokenu.
  • video_url: plik, który TikTok pobiera, MP4, MOV lub WebM, w zweryfikowanej domenie lub prefiksie adresu URL.
  • post_info: wymagany przy każdym wywołaniu, nawet jako pusty obiekt, i zawiera ustawienia posta.
  • post_info.caption: do 2 200 znaków liczonych w UTF-16, z #hashtagami i do 30 wzmianek @.
  • post_info.is_brand_organic i is_branded_content: etykiety Treści promocyjne i Płatna współpraca, które tabela TikToka oznacza jako wymagane.
  • post_info.disable_comment, disable_duet i disable_stitch: true wyłącza komentarze, Duet lub Stitch; wszystkie trzy domyślnie mają wartość false.

Co zwraca TikTok?

Zwykłą kopertę odpowiedzi, z identyfikatorem zadania publikacji w polu data. Kod 0 oznacza, że TikTok przyjął zadanie, a nie że wideo jest już na żywo: TikTok nadal musi pobrać plik, sprawdzić go i poddać post moderacji. W przykładach TikToka share_id wideo zaczyna się od v_pub_url, a posta ze zdjęciem od p_pub_url.

The publish response
{
  "code": 0,
  "message": "Ok",
  "request_id": "20210817034316010245031056097316BA",
  "data": {
    "share_id": "v_pub_url~v1.2345123456789123456"
  }
}

Jak śledzić post, aż będzie opublikowany?

Za pomocą GET /business/publish/status/, przekazując business_id oraz share_id jako publish_id. Pole status ma wartość PROCESSING_DOWNLOAD, gdy TikTok pobiera plik, PUBLISH_COMPLETE, gdy post przeszedł moderację, albo FAILED z podaniem przyczyny. post_ids pojawia się wraz z PUBLISH_COMPLETE, gdy post jest publicznie widoczny, i może opóźnić się do trzech minut. Cały przepływ w Pythonie:

Publish and follow a video in Python
import os, time, requests

API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"]  # open_id from the token exchange

def call(method, path, **kwargs):
    body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
    if body.get("code") != 0:  # errors arrive in code, usually with HTTP 200
        raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
    return body["data"]

share_id = call("POST", "business/video/publish/", json={
    "business_id": BUSINESS_ID,
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {"caption": "Our new menu is live #food",
                  "is_brand_organic": False, "is_branded_content": False},
})["share_id"]

for _ in range(30):
    time.sleep(60)  # each check is a call; TikTok's stages take minutes
    s = call("GET", "business/publish/status/",
             params={"business_id": BUSINESS_ID, "publish_id": share_id})
    if s["status"] == "FAILED":
        raise RuntimeError(s.get("reason"))
    if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
        print("Live:", s["post_ids"])
        break

Czy webhook może zastąpić sprawdzanie statusu?

Tak, dla aplikacji subskrybującej event_type VIDEO przez /business/webhook/update/. TikTok wysyła wtedy post.publish.failed lub post.publish.complete, gdy pobierze i sprawdzi plik, post.publish.publicly_available z nowym post_id, gdy post przejdzie moderację, oraz post.publish.no_longer_publicly_available, jeśli post później przestanie być publiczny. Każde zdarzenie wskazuje zadanie w publish_id, czyli tę samą wartość co share_id.

Jak opublikować wideo przez MCP?

Poproś o to zwykłym językiem w Claude, ChatGPT lub innym kliencie połączonym z https://easycoexistence.com/api/mcp. Asystent wywołuje publish_tiktok_post z account_id z list_social_accounts, adresem HTTPS w video_url, podpisem i, jeśli chcesz wyłączyć komentarze, disable_comment. Wynik zawiera share_id od TikToka, a get_tiktok_publish_status, mając account_id i ten share_id, zwraca status TikToka, post_ids i pole reason, takie jakie są w danej chwili.

The MCP tool calls and their results
publish_tiktok_post {
  "account_id": "<ACCOUNT_ID>",
  "video_url": "https://media.example.com/tiktok/launch.mp4",
  "caption": "Our new menu is live #food",
  "disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
     "note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }

get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }

Co publish_tiktok_post wysyła do TikToka?

Wywołanie tego samego endpointu, uzupełnione na podstawie Twojego żądania. Twój link trafia do TikToka jako podpisany link pod własną trasą mediów easyCoexistence, zweryfikowaną przez nas, więc nie wymaga osobnej weryfikacji. Podpis i disable_comment idą tak, jak je podasz, a is_brand_organic i is_branded_content idą jako false. Pozostałe ustawienia, takie jak Duet, Stitch, okładka i etykieta wygenerowana przez AI, zachowują domyślne wartości TikToka, a wideo jest publikowane jako post publiczny, zgodnie z konstrukcją endpointu.

Co można zrobić z danymi uwierzytelniającymi z Partner API?

Wywoływać TikToka bezpośrednio jako konto. GET /channels/{id}?credentials=1 na https://easycoexistence.com/api/v1, z kluczem ec_live_ jako tokenem bearer, zwraca kanał z obiektem credentials: api_base, business_id, aktualny access_token i token_expires_at. Sprawdzanie statusu, listy wideo, komentarze i statystyki działają wtedy z Twojego kodu. Sama publikacja wymaga przemyślenia: bezpośrednie wywołanie publikacji przekazuje video_url do TikToka bez zmian, domenę lub prefiks dodaje się przy użyciu własnego ID i sekretu aplikacji deweloperskiej, a prefiks zweryfikowany przez aplikację easyCoexistence to jej trasa mediów, z której korzysta publish_tiktok_post.

Credentials from the Partner API, then a direct status check
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

# "credentials": {
#   "platform": "tiktok",
#   "api_base": "https://business-api.tiktok.com/open_api/v1.3",
#   "business_id": "<OPEN_ID>",
#   "access_token": "<ACCESS_TOKEN>",
#   "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }

curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'publish_id=<SHARE_ID>'

Jak to skonfigurować

  1. Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
  2. Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
  3. Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.

Typowe błędy

  • Pominięcie post_info. TikTok wymaga tego obiektu przy każdym wywołaniu, nawet gdy żadne ustawienie się nie zmienia.
  • Szukanie ID posta w odpowiedzi publikacji. Zwraca ona tylko share_id; ID postów pochodzą z wywołania statusu lub ze zdarzenia post.publish.publicly_available.
  • Ponawianie wywołania publikacji, które przekroczyło czas oczekiwania. Pierwsze żądanie mogło dotrzeć do TikToka, więc przed ponowieniem sprawdź najnowsze posty konta.
  • Traktowanie kodu 0 jako opublikowanego wideo. Oznacza on, że TikTok przyjął zadanie, a plik może nadal nie przejść sprawdzeń po pobraniu.
Z EasyCoexistence zrobisz to

Od US$ 9 do US$ 0,75 za połączenie miesięcznie, a cena spada w miarę dodawania połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.

Najczęściej zadawane pytania

Który endpoint publikuje wideo na TikToku?

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, z tokenem konta w nagłówku Access-Token oraz business_id, video_url i post_info w treści JSON.

Czy API TikToka może przesłać plik wideo bezpośrednio?

Nie przez /business/video/publish/. Endpoint przyjmuje video_url i pobiera plik spod tego adresu, więc wideo potrzebuje adresu URL w zweryfikowanej domenie lub prefiksie.

Jak uzyskać ID wideo opublikowanego przez API?

Z post_ids w /business/publish/status/, gdy status ma wartość PUBLISH_COMPLETE i post jest publiczny, albo z post_id w webhooku post.publish.publicly_available.

Czy mogę zaplanować publikację wideo na TikToku przez API?

Endpoint publikacji wysyła post w chwili wywołania i nie ma pola czasu. easyCoexistence przechowuje zaplanowane posty we własnej kolejce i wywołuje TikToka o czasie, który ustawisz.

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