API: příspěvky do plánovače a fotky pro web

API je pro programátora vašeho webu, redakčního systému nebo pro nástroje jako Make, Zapier či n8n. Přes něj pošlete do plánovače hotový příspěvek — text, fotky nebo videa, na které sítě, kdy, a jestli vyjde automaticky, nebo ho zveřejní člověk ručně. Stejným klíčem si web umí stáhnout fotky a videa z knihovny.

Klíč

1. V aplikaci otevři Nastavení → API a napojení.
2. Klikni Vydat klíč a vyber, co má umět: příspěvky jen připravit, příspěvky připravit i vydat, nebo číst knihovnu.
3. Klíč hned zkopíruj — ukáže se jen jednou. V databázi zůstává jen jeho otisk.

Klíč se posílá v hlavičce Authorization: Bearer <klíč>, adresa API je https://theis.cz/api/v1.

Poslat příspěvek do plánovače

curl -X POST https://theis.cz/api/v1/prispevky \
  -H "Authorization: Bearer <klíč>" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Finále je za námi!",
    "site": ["instagram", "facebook"],
    "media": ["https://vas-web.cz/foto.jpg"],
    "kdy": "2026-10-20T18:00",
    "stav": "naplanovat",
    "nastaveni": { "instagram": { "rezim": "rucne", "kdo": "jana@firma.cz" } }
  }'

Odpověď vrátí id příspěvku, jeho stav, stav u každé sítě a odkaz do aplikace. Příspěvek se hned objeví v plánovači.

Co se dá poslat

• text — společný text příspěvku.
• site — kam má jít: youtube, instagram, facebook, tiktok, threads, linkedin.
• texty — vlastní text pro jednotlivou síť, třeba kratší verze pro Threads.
• media — adresy fotek, videí nebo PDF. THEIS si je stáhne k sobě. Velké soubory nahraj přes /soubory (níž).
• nahledovka — obálka videa (adresa fotky). Když ji nepošlete, THEIS si sám vezme snímek z videa, aby ho plánovač měl co ukázat.
• kdy — čas vydání. Bez časového pásma se bere český čas.
• stav — koncept (výchozí), kontrola, nebo naplanovat.
• kontroluje a poznamka — u stavu kontrola e-mail kolegy, který příspěvek zkontroluje, a vzkaz pro něj.
• rezim — auto (výchozí), nebo rucne. Jde nastavit i pro každou síť zvlášť.
• kdo — u ručního režimu e-mail člověka, kterému přijde upozornění, že je řada na něm. Bez něj to dostane autor klíče.
• nastaveni — pro každou síť zvlášť: typ (prispevek, reel, story; u YouTube video nebo short), ucet, rezim, kdo, prvni_komentar, u YouTube nazev a viditelnost, u Threads vlakno a anketa.
• nastaveni.instagram.hudba — hudba z knihovny Instagramu k Reelu (viz níž).
• nastaveni.tiktok — viditelnost, interakce, označení reklamy a souhlas pro TikTok (viz níž).
• odkaz — odkazový příspěvek s náhledem stránky (Facebook, LinkedIn, Threads).
• stitky — štítky do plánovače.
• externi_id — vaše vlastní značka příspěvku. Stejná podruhé nic nového nezaloží, takže opakovaný pokus nevydá příspěvek dvakrát.

Koncept, kontrola, nebo rovnou k vydání

• koncept — příspěvek čeká v plánovači, dokud ho někdo neschválí. Uloží se i nehotový a odpověď vypíše, co mu chybí.
• kontrola — příspěvek jde ke kontrole konkrétnímu člověku a ten dostane upozornění. Musí mít oprávnění schvalovat.
• naplanovat — příspěvek se zařadí k vydání na čas v kdy. Jde jen s klíčem, který smí příspěvky vydávat. Když něco nesplňuje pravidla sítě, API ho odmítne a napíše proč.

Automaticky, nebo ručně

V režimu auto příspěvek v daný čas vyjde sám. V režimu rucne přijde v daný čas upozornění člověku v kdo a ten příspěvek zveřejní sám — hodí se pro Stories s nálepkami nebo pro síť, kde chcete mít poslední slovo.

Hudba k Reelu na Instagramu

K Reelu — jednomu videu jako Reel nebo Příspěvek — umí API přidat skladbu z hudební knihovny Instagramu. Vyberete ji v nastaveni.instagram.hudba:

• "trend" — skladba, která bude nejtrendovější ve chvíli zveřejnění. {"trend": 3} vezme třetí v pořadí.
• {"id": "…"} — konkrétní skladba. Id vrátí GET /hudba.
• {"hledat": "…", "poradi": 1} — skladba z hledání podle názvu nebo interpreta, bez poradi ta první.

Hlasitost se nastaví v hlasitost_hudby a hlasitost_videa (1 až 100) — třeba když má být ve videu slyšet hlavně mluvené slovo.

"nastaveni": { "instagram": { "typ": "reel", "hudba": { "trend": 1, "hlasitost_videa": 30 } } }

GET /hudba vypíše, co je na Instagramu zrovna trendy, a s ?hledat=… hledá. Nabídka je menší než v aplikaci Instagram — jsou v ní jen skladby, které Instagram povoluje používat mimo svou aplikaci. K fotce, karuselu ani Story Instagram hudbu přes API přidat neumí.

TikTok

TikTok vydá příspěvek automaticky, jen když v nastaveni.tiktok pošlete totéž, co člověk vyplní v aplikaci. Nic se nepředvyplňuje:

• viditelnost — povinná: vsichni, pratele, sledujici, nebo jen_ja. Účet musí danou volbu mít; které má, ověří THEIS u TikToku hned při přijetí.
• souhlas — povinně true: souhlas s TikTok Music Usage Confirmation, u placené spolupráce i s Branded Content Policy.
• komentare, duet, stitch — true, nebo false (výchozí). Co má účet v nastavení TikToku vypnuté, zůstane vypnuté.
• oznaceni — zadne (výchozí), vlastni (propagujete sebe), placena (placená spolupráce), nebo obe. Placená spolupráce nesmí mít viditelnost jen_ja.

"nastaveni": { "tiktok": { "viditelnost": "vsichni", "souhlas": true, "komentare": true } }

Bez viditelnosti a souhlasu jde TikTok jako koncept, ke kontrole, nebo s ručním režimem.

Velké fotky a videa

Přes adresu v media bere THEIS fotky do 25 MB, videa do 500 MB a PDF do 110 MB. Větší soubor nahraj napřímo:

1. POST /soubory s {"soubor": "video.mp4"} vrátí adresu nahrat.
2. Soubor pošli na tu adresu metodou PUT s hlavičkou Content-Type.
3. V příspěvku ho pak uveď jako {"soubor": "…"} s hodnotou, kterou vrátil první krok.

Jak je na tom příspěvek

GET /prispevky/<id> vrátí stav příspěvku (koncept, kontrola, naplanovano, vydano, chyba) a u každé sítě zvlášť, jestli čeká ve frontě, čeká na člověka, už vyšla — i s odkazem na zveřejněný příspěvek — nebo co se pokazilo. GET /prispevky vypíše příspěvky, které založil tenhle klíč.

Úprava a smazání

PATCH /prispevky/<id> změní, co pošleš — ostatní zůstane. DELETE /prispevky/<id> příspěvek smaže. Obojí jde jen dokud příspěvek nevyšel a dokud ho mezitím nikdo neupravil v aplikaci, aby API nepřepsalo práci člověka.

Pravidla sítí

Platí stejná pravidla jako v aplikaci. Instagram bere jen fotky JPG do 8 MB, YouTube jen jedno video s názvem, Reel jde jen z videa a Threads unese text do 500 znaků.

TikTok vydá automaticky jen s vyplněnou viditelností a souhlasem (viz výš).

GET /site vypíše připojené účty a sítě, kam smí klíč vydávat.

Fotky a videa z knihovny pro váš web

Klíč pro knihovnu vrací schválené fotky a videa: GET /media se seznamem (filtry podle akce, štítku a změn od data) a GET /media/<id> s jednou položkou. U každé přijde náhled, větší verze a originál — nic se nepřevádí.