Integrace API

TikTok Posting API pro distribuci na více účtů s bezpečnou frontou

Vytvářejte pracovní postupy publikování na TikTok s explicitním sledováním stavu, orchestrací odolnou vůči retry a zpracováním zohledňujícím moderaci pro týmy v produkčním měřítku.

Problém

Ve větším měřítku distribuce selhává tam, kde je publikování stále manuální: akce upload/publish se stávají křehkými napříč mnoha účty, harmonogramy a stavy moderace.

Výsledek se Ssemble

Ssemble podporuje generování obsahu a orchestraci stavů, zatímco vaše vrstva publikování na TikTok provádí řízená publikování s idempotencí, retries a auditovatelnými stavy úloh.

Základy implementace

Base URL: https://aiclipping.ssemble.com/api/v1 (+ TikTok Open API for publish)

Architektura integrace (ingest → zpracování → poll/webhook → publikování)

1) Ingest

Uložte source URL/file URL + cílový účet + scheduleAt + idempotency key do modelu úloh vašeho publisheru.

2) Zpracování

Zavolejte POST /shorts/create, zachovejte requestId a připojte jej k navazujícím úlohám publikování.

3) Poll / Webhook

Přesouvejte úlohy skrze stavy processing/ready/failed pomocí GET /shorts/:id/status a záložních událostí.

4) Publikování

Spusťte publikování na TikTok s limity souběžnosti na účet, retry politikou a konečnou reconciliací stavu.

Příklady endpointů

POST /shorts/create— Vygenerování short-form assetu před publikováním
GET /shorts/:id/status— Sledování životního cyklu zpracování a failureReason
GET /shorts/:id— Získání metadat dokončeného výstupu pro publikování

Pokyny k autentizaci

Používejte X-API-Key na straně serveru pro Ssemble a udržujte TikTok OAuth tokeny izolované ve své službě publikování. Rotujte každou sadu klíčů nezávisle podle prostředí.

Rate limity a opakování (retries)

Zacházejte s generováním a publikováním jako se samostatnými rozpočty. Serializujte mutující volání na cílový účet a při 429 respektujte reset/retryAfter s exponenciálním backoffem + jitterem.

Příklad požadavku

POST /api/publish/tiktok
{
  "jobId": "job_01HT...",
  "requestId": "665a1b2c3d4e5f6a7b8c9d0e",
  "tiktokAccountId": "acct_kor_store_03",
  "scheduleAt": "2026-03-10T18:00:00Z",
  "idempotencyKey": "2f182b63-312f-4290-9222-7cf6f7f8f12d"
}

Příklad odpovědi

200 OK
{
  "jobId": "job_01HT...",
  "state": "publish_processing",
  "publishId": "v_inbox_file~v2.123456789",
  "nextCheckAt": "2026-03-10T18:00:30Z"
}

Příklad chybového scénáře

429 Too Many Requests
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Per-account posting throttle reached",
    "details": { "retryAfter": "2026-03-10T18:01:00Z" }
  }
}

Verzování

Připněte (pin) verze endpointů a logujte upstream version metadata u každého požadavku, aby byly regrese integrace dohledatelné.

Podpora

Pro triáž incidentů zachovejte requestId + publish_id + account id + error.code + upstream log_id v jednom dohledatelném záznamu.

Rychlý start

Vytvořte SSEMBLE_API_KEY a uložte jej do backend secrets.
Zavolejte POST /shorts/create a zachovejte requestId ve své tabulce úloh.
Pollujte GET /shorts/:id/status každých 10 sekund až do konečného stavu.
Po dokončení publikujte na TikTok přes frontu svého serveru.
Zpracujte 429/5xx s omezenými retries a stabilními idempotency keys.

Otevřít dokumentaci publikování na TikTok

Zahájit integraci

1) Autentizace

Formát API key a zpracování chyb autentizace

2) Referenční přehled endpointů

Kontrakty create/status/list/delete

3) Zpracování chyb

Vzory chyb s možností retry versus terminální

4) Ukázky kódu

Integrační snippety připravené k implementaci

Třífázový pracovní postup

Vygenerujte short-form assety a uložte requestId spolu s kontextem publikování do své tabulky úloh.
Sledujte zpracování pomocí status pollingu nebo webhooks a deterministicky přesouvejte úlohy do stavů ready/failed.
Publikujte na TikTok s řízením throttle na účet, idempotency keys a logy pro reconciliaci.

Proč si týmy volí Ssemble

Navrženo pro týmy distribuce na více účtů, kde je spolehlivost fronty důležitější než jednorázový úspěch.
Odděluje záležitosti renderingu a publikování, takže selhání jsou izolována a lze je obnovit.
Podporuje zpracování stavů zohledňující moderaci: dokončení uploadu neznamená vždy konečnou veřejnou dostupnost.

Další krok

Otevřít rychlý start publikování na TikTok Zobrazit ceny Dokumentace pro vývojáře

Časté dotazy

Můžeme považovat úspěšný upload za publikovaný?

Ne vždy. Udržujte samostatné stavy pro uploaded, submitted, publish_complete a publicly_available, abyste se vyhnuli falešně pozitivním výsledkům.

Který krok musí být idempotentní?

Minimálně zahájení publikování. Používejte jeden stabilní idempotency key na úlohu, aby retries nevytvářely duplikáty.

Polling nebo webhooks: co bychom měli použít?

Používejte webhooks jako primární mechanismus, když jsou dostupné, a ponechte polling jako záložní řešení pro reconciliaci a zmeškané události.

Jak se vyhnout nárazům 429 napříč mnoha účty?

Rozdělte (shard) fronty podle cílového účtu a vynucujte limity souběžnosti na účet místo jedné globální nárazové fronty.

Které logy jsou povinné pro reakci na incidenty?

Zaznamenejte requestId, publish_id, account id, přechody stavů a error code pro podporu deterministického debuggingu.

Zaručuje to dobu dokončení moderace?

Ne. Okna moderace se liší, takže produkční systémy by měly zacházet s časem konečné dostupnosti jako s asynchronním a proměnlivým.