Zpět do aplikace

API & AI Agenti

Zapostuj.cz nabízí moderní REST API připravené na propojení s vašimi vlastními AI agenty (ChatGPT, Claude, Make.com) a aplikacemi.

Proč máme REST API (OpenAPI) a ne MCP (Model Context Protocol)?

Zvolili jsme průmyslový standard OpenAPI, protože je univerzálnější. MCP se typicky využívá pro lokální aplikace běžící na vašem počítači, zatímco Zapostuj.cz je cloudová služba. OpenAPI navíc nativně podporují přímo Custom GPTs (ChatGPT), Cursor, Copiloti a platformy jako Zapier nebo Make.com. Pro Claude Desktop můžete využít standardní nástroj mcp-server-openapi.

1. Získání API Klíče

Pro komunikaci s API potřebujete přístupový klíč. Všechny požadavky musí obsahovat tento klíč v hlavičce Authorization: Bearer VÁŠ_KLÍČ.

  1. Přihlaste se do vašeho Zapostuj.cz účtu.
  2. Přejděte do sekce Nastavení.
  3. Klikněte na záložku API & AI Agenti.
  4. Klikněte na tlačítko Vygenerovat nový API klíč.
  5. Klíč si bezpečně zkopírujte (zobrazí se pouze jednou!).

2. Integrace pro AI Agenty (ChatGPT, Claude)

Nejrychlejší způsob, jak naučit vašeho AI agenta plánovat příspěvky, je poskytnout mu náš OpenAPI formát. Agent díky němu okamžitě pochopí všechny endpointy a parametry.

https://zapostuj.cz/openapi.json

V ChatGPT (Custom GPTs): Přejděte do nastavení vašeho GPT, klikněte na Create new action, vložte URL výše do pole pro import z URL, uložte, a v sekci Authentication nastavte typ na API Key (Auth Type: Bearer) a vložte váš vygenerovaný klíč.

3. REST API Endpointy

Základní URL pro všechny API požadavky je https://zapostuj.cz/api/public/v1.

GET/accounts

Vrátí seznam všech sociálních profilů (Facebook, Instagram, LinkedIn, atd.) připojených k vašemu účtu.

curl -X GET https://zapostuj.cz/api/public/v1/accounts \ -H "Authorization: Bearer vas_api_klic"

Příklad odpovědi:

{ "accounts": [ { "id": "12345", "platform": "facebook", "name": "Moje Stránka" } ] }
POST/schedule

Naplánuje nový příspěvek na vybrané sociální sítě.

curl -X POST https://zapostuj.cz/api/public/v1/schedule \ -H "Authorization: Bearer vas_api_klic" \ -H "Content-Type: application/json" \ -d '{ "content": "Ahoj světe! Toto je post přes API.", "platforms": ["facebook", "linkedin"], "scheduledFor": "2026-12-24T18:00:00Z", "mediaUrls": ["https://example.com/image.jpg"] }'
ParametrTypPopis
contentString (povinný)Text příspěvku. Může obsahovat emoji.
platformsArray (povinný)Pole sítě, např. ["facebook", "instagram", "linkedin", "tiktok", "pinterest", "mastodon", "bluesky", "youtube"].
scheduledForString (volitelný)ISO-8601 formát data a času. Pokud není vyplněno, příspěvek se publikuje ihned.
mediaUrlsArray (volitelný)Pole URL adres k obrázkům nebo videím (max 10).