API pro publikaci tiskových zpráv

Posílejte tiskové zprávy na CSA News přímo ze svého webu, CMS nebo PR systému. Platí stejná pravidla jako v editoru: zpráva projde kontrolou redakce, Premium ji přeloží do češtiny, slovenštiny, angličtiny a němčiny.

Přístup

API je součástí placené služby – zpřístupní se firmám, které si koupily kredity. Klíč si vytvoříte po přihlášení v Nastavení profilu → API pro publikaci zpráv. Klíč se zobrazí jen jednou; kdykoli ho můžete zneplatnit.

Každý požadavek nese hlavičku:

Authorization: Bearer csa_…

Odpovědi jsou v JSON (UTF-8). Limit je 60 požadavků za hodinu na klíč.

Odeslání zprávy

POST https://csanews.cz/api/v1/zpravy

curl -X POST https://csanews.cz/api/v1/zpravy \
  -H "Authorization: Bearer $CSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "tz-2026-041",
    "title": "Firma otevírá nové výrobní centrum v Brně",
    "perex": "Nové centrum vytvoří 120 pracovních míst.",
    "html": "<p>Brno, 19. října 2026 – …</p><h2>Mezititulek</h2><p>…</p>",
    "lang": "cs",
    "date": "2026-10-19",
    "premium": true,
    "topics": ["zpracovatelsky-a-vyrobni-prumysl"],
    "media_contact": {"name": "Jana Nováková", "email": "[email protected]", "phone": "+420 777 123 456"},
    "images": [{"url": "https://www.firma.cz/foto/centrum.jpg", "source": "Firma s.r.o."}]
  }'

Pole	Povinné	Význam
`title`	ano	Nadpis, nejvýš 300 znaků.
`html` nebo `text`	ano	Text zprávy. HTML: odstavce, mezititulky (`h2`, `h3`), seznamy, tučné písmo, odkazy. V textu se odstavce oddělují prázdným řádkem, mezititulek začíná `##` .
`premium`	ne	`true` = Premium (strhne 1 kredit, při zamítnutí se vrací). Výchozí `false` – zdarma: jen text a mezititulky v jednom jazyce, odkazy neaktivní, bez fotek.
`lang`	ne	Jazyk zprávy: `cs`, `sk`, `en`, `de`. Výchozí `cs`.
`perex`	ne	Krátké shrnutí (perex a popis pro vyhledávače).
`date`	ne	Datum vydání `RRRR-MM-DD`, nejpozději dnes. Výchozí dnes.
`topics`	ne	Až 3 témata (slugy z `GET /temata`).
`media_contact`	ne	Kontakt pro média: `name`, `email`, `phone`, `company`.
`images`	ne	Až 6 fotek: `[{"url": "https://…", "source": "autor"}]`. Jen veřejné adresy, nejvýš 10 MB. Zobrazí se u Premium.
`external_id`	ne	Vaše vlastní id zprávy. Opakované volání se stejným id vrátí už založenou zprávu místo duplicity (hodí se při výpadku spojení).
`submit`	ne	Výchozí `true` – zprávu rovnou pošle ke schválení. `false` = jen koncept.

Odpověď 201 vrátí zprávu (viz níže). Zprávu pak zkontroluje redakce; po zveřejnění najdete adresy v poli url a pošleme vám e-mail.

Stav zprávy

GET https://csanews.cz/api/v1/zpravy/{id}

{
  "id": 412,
  "external_id": "tz-2026-041",
  "stav": "zverejneno",
  "ceka_uprava": false,
  "premium": true,
  "jazyk": "cs",
  "jazyky": ["cs", "sk", "en", "de"],
  "title": "Firma otevírá nové výrobní centrum v Brně",
  "datum": "2026-10-19",
  "vytvoreno": "2026-10-19T09:12:00+02:00",
  "zverejneno": "2026-10-19T10:03:00+02:00",
  "url": {"cs": "https://csanews.cz/cs/firma-otevira-…", "sk": "https://csanews.cz/sk/…", "en": "…", "de": "…"},
  "pdf": {"cs": "https://csanews.cz/pdf/412/cs", "…": "…"},
  "temata": ["zpracovatelsky-a-vyrobni-prumysl"],
  "fotky": 1,
  "media_contact": {"contact_name": "Jana Nováková", "contact_email": "[email protected]", "contact_phone": "+420 777 123 456"}
}

Stavy: koncept, ceka_na_schvaleni, zverejneno, zamitnuto. Seznam vašich zpráv: GET https://csanews.cz/api/v1/zpravy?stav=zverejneno&limit=20&offset=0.

Úprava

PATCH https://csanews.cz/api/v1/zpravy/{id} – pošlete jen pole, která měníte (title, html/text, perex, date, topics, media_contact). Úprava zveřejněné zprávy čeká na schválení, do té doby zůstává zveřejněná původní verze. Koncept nebo zamítnutou zprávu znovu odešlete s "submit": true.

Další jazyková verze

POST https://csanews.cz/api/v1/zpravy/{id}/jazyky/{sk|en|de|cs} s title, html nebo text a volitelně perex. Hodí se pro zprávy zdarma (Premium překládáme sami) nebo když máte vlastní překlad.

Fotky

POST https://csanews.cz/api/v1/zpravy/{id}/fotky – jako soubor (multipart, pole file, volitelně source) nebo JSON {"url": "https://…", "source": "…"}. JPG, PNG, WebP nebo GIF, nejvýš 6 fotek na zprávu.

curl -X POST https://csanews.cz/api/v1/zpravy/412/fotky \
  -H "Authorization: Bearer $CSA_API_KEY" \
  -F "[email protected]" -F "source=Firma s.r.o."

Témata

GET https://csanews.cz/api/v1/temata – slugy a názvy témat ve všech jazycích.

Chyby

Kód	Kdy
400	Tělo není platný JSON.
401	Chybí nebo nesedí API klíč.
402	Na Premium zprávu chybí kredit.
403	Účet nemá přístup k API (bez kreditů).
404	Zpráva neexistuje nebo není vaše.
409	Zprávu v tomto stavu nejde upravit.
422	Chybí nebo je špatně vyplněné pole – důvod je v `chyba`.
429	Překročen hodinový limit (hlavička `Retry-After`).

Každá chyba vrací JSON {"chyba": "…"} s vysvětlením v češtině.

Příklad v PHP

$ch = curl_init('https://csanews.cz/api/v1/zpravy');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('CSA_API_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'external_id' => 'tz-2026-041',
        'title' => 'Firma otevírá nové výrobní centrum v Brně',
        'html' => '<p>…</p>',
        'premium' => true,
    ]),
]);
$zprava = json_decode(curl_exec($ch), true);
echo $zprava['id'], ' ', $zprava['stav'];

Dotazy k API: [email protected].