---
title: "Posty API and CLI reference: REST, MCP, OpenAPI | API dokumentace"
description: "Posty API documentation: every public REST endpoint with curl examples, the posty-cli command reference, the MCP tool list, authentication, error model, rate limits and the versioning policy. Kompletní referenční příručka veřejného API a nástroje příkazové řádky Posty."
canonical: https://posty.hu/cs/api
source: https://posty.hu/cs/api.md
---

API dokumentace

# Posty API, MCP a CLI reference

Tato stránka je kompletní referenční příručka programovatelných rozhraní Posty: každý veřejný REST endpoint, všechny příkazy nástroje příkazové řádky a nástroje MCP serveru. Pokud jste se ještě nerozhodli, které rozhraní potřebujete, začněte [přehledem pro vývojáře](https://posty.hu/cs/vyvojari).

Ke každému endpointu je v kompletní dokumentaci samostatná stránka, s parametry a spustitelnými příklady: [posty.hu/dokumentacio/api/vegpontok](https://posty.hu/cs/dokumentace/api/koncove-body).

## Jak to funguje

Posty přes tři rozhraní spravuje stejný pracovní prostor jako webová aplikace. **REST API** z vašeho vlastního kódu, **nástroj příkazové řádky** z terminálu a vašich skriptů, **MCP server** z AI agenta. Všechna tři používají stejná oprávnění a limity, proto co zvládnete na jednom, zvládnete i na ostatních.

Základní adresa REST API je `https://api.posty.hu/public/v1`. Verze je v cestě a každá odpověď je JSON.

### Připojení ve třech krocích

1. Zaregistrujte se na [posty.hu/regisztracio](https://posty.hu/regisztracio). Žádný prodejní hovor, žádná čekací listina.
2. V rozhraní propojte alespoň jeden sociální účet. Tento krok z API neuděláte, protože platforma chce souhlas od člověka.
3. Vytvořte si klíč: Nastavení → Vývojáři. Klíč se ukáže jen jednou, v okamžiku vytvoření.

Prvním voláním si ověříte, že je vše na svém místě. Tento endpoint odpoví i bez klíče a řekne vám, kde najdete všechno:

```
curl https://api.posty.hu/public/v1/status
```

První ověřené volání vypíše vaše kanály:

```
curl https://api.posty.hu/public/v1/integrations \
  -H "Authorization: psty_a_kulcsod"
```

### Autentizace

Fungují dva typy přihlašovacích údajů. **API klíč** je celá hodnota hlavičky `Authorization` (`psty_…`) a je určený pro váš vlastní kód. Přístupový token **OAuth 2.1** (`Bearer pos_…`) potřebujete, když k Posty přistupuje jiná aplikace jménem vašich uživatelů. Průběh používá PKCE a metadata jsou strojově čitelná.

Oprávnění klíče se řídí aktuální rolí jeho vlastníka. Když je někdo přeřazen na nižší roli nebo odebrán z pracovního prostoru, klíč umí hned jen to, co smí on. Pokud klíč patří k více pracovním prostorům, hlavička `showorg` mezi nimi vybere.

## Endpointy

Každá cesta je pod `https://api.posty.hu/public/v1`. Sloupec „Oprávnění" ukazuje, jaký scope klíč potřebuje. Když chybí, odpověď je 403 a pojmenuje, co chybí.

| Metoda | Cesta | Co dělá | Oprávnění |
| --- | --- | --- | --- |
| GET | /status | Állapot és felderítés. Az egyetlen útvonal, amely kulcs nélkül is válaszol. | — |
| GET | /is-connected | Ellenőrzi, hogy a kulcs érvényes munkaterületre mutat-e. | — |
| GET | /integrations | A bekötött csatornák: azonosító, név, @handle, platform, és hogy tud-e most posztolni. | channels:read |
| GET | /integration-settings/:id | Egy csatorna posztolási szabályai és beállítássémája, a fiókra feloldott karakterkorláttal. | channels:read |
| POST | /integration-trigger/:id | Platformspecifikus lekérdezés egy csatornán: táblák, subredditek, oldalak listája. | channels:read |
| GET | /social/:integration | Visszaadja azt a platformcímet, amit egy embernek meg kell nyitnia a csatorna bekötéséhez. | channels:write |
| GET | /groups | Az ügyfélcsoportok, amelyekbe a csatornák be vannak sorolva. | channels:read |
| GET | /posts | A naptár egy időszakra: minden poszt állapottal és időponttal. | posts:read |
| POST | /posts | Poszt létrehozása: piszkozat, ütemezés vagy azonnali közzététel, egy vagy több csatornára. | posts:draft (közzétételhez posts:publish is) |
| DELETE | /posts/:id | Egy poszt törlése és a hozzá tartozó folyamat leállítása. | posts:draft |
| DELETE | /posts/group/:group | A teljes csoport törlése: egy szerkesztés, ami több csatornára ment ki, egyetlen posztnak számít. | posts:draft |
| PUT | /posts/:id/status | Poszt átmozgatása piszkozat és ütemezett állapot között. | posts:publish |
| GET | /posts/:id/missing | Megmondja, mi hiányzik még a poszthoz a közzétételhez. | posts:read |
| PUT | /posts/:id/release-id | A platformon kívül közzétett poszt azonosítójának és címének rögzítése. | posts:publish |
| GET | /find-slot/:id | A következő szabad időpont a munkaterület ütemezése szerint. | posts:read |
| POST | /upload | Kép vagy videó feltöltése a médiatárba, legfeljebb 1 GB. | media:write |
| POST | /upload-from-url | Médiafájl behúzása nyilvános URL-ről a médiatárba. | media:write |
| POST | /upload-link | Böngészős feltöltési link, ha a fájl a felhasználó eszközén van. | media:write |
| GET | /upload-link/:id | A feltöltési linken beérkezett fájlok, a posztba tehető címmel. | media:write |
| GET | /analytics/:integration | Egy csatorna statisztikái a kért időszakra. | analytics:read |
| GET | /analytics/post/:postId | Egy közzétett poszt platformstatisztikái. | analytics:read |
| GET | /notifications | A munkaterület értesítései, lapozva. | posts:read |

Přesná schémata požadavku a odpovědi, pole po poli, najdete v [popisu OpenAPI 3](https://posty.hu/openapi.json). Z něj si můžete nechat vygenerovat i kód klienta.

### Příklad: naplánovaný příspěvek

Datum je vždy UTC, ve formátu ISO 8601. `type` může být `draft`, `schedule` nebo `now`.

```
curl -X POST https://api.posty.hu/public/v1/posts \
  -H "Authorization: psty_a_kulcsod" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "date": "2026-09-15T09:00:00.000Z",
    "shortLink": false,
    "posts": [{
      "integration": { "id": "a_csatorna_azonositoja" },
      "value": [{ "content": "<p>Sziasztok!</p>" }]
    }]
  }'
```

Odpověď vrací jeden řádek na kanál, s hodnotou `postId`, kterou použijete při mazání a při změně stavu.

## Chyby

Každá chyba je JSON. U chyb, které vyvolá Posty, nese lidskou větu pole `msg`. Volání, která neprojdou kontrolou formátu požadavku, dostanou tvar frameworku (`statusCode`, `message`, `error`). Oprávnění 403 pojmenuje chybějící scope a roli vlastníka klíče, protože nejčastější příčina není špatný klíč, ale uživatel se sníženou rolí.

Stavový kód řekne, jestli má smysl to zkusit znovu: 400, 401, 403 a 404 nezmizí, dokud něco nezměníte. 429 a 5xx ano. Schéma `ApiError` toto všechno popisuje i strojově čitelně v dokumentu OpenAPI.

## Limity volání

Každá odpověď nese hlavičky `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (v sekundách, ne jako časové razítko) a `RateLimit-Policy`. S kódem 429 přijde i `Retry-After`. Každá cesta má vlastní okno, na klíč. Nečekejte na 429: ze zbývající hodnoty můžete zpomalit předem.

## Verze a vyřazování

Verze je v cestě: každé veřejné volání žije pod `/public/v1`. Nekompatibilní změna by se objevila jako nová verze (`/public/v2`) a v1 si drží svou smlouvu. Rozšíření (nové volitelné pole, nová cesta, nová hodnota výčtu) probíhá uvnitř v1, proto váš kód ignoruje pole, která nezná.

Kdybychom cestu vyřazovali, odpověď by dostala hlavičku `Deprecation: true` a v hlavičce `Sunset` datum, po kterém už nebude fungovat. Toto datum není nikdy blíž než 180 dní. Každá odpověď nese i hlavičku `Link` se vztahem `rel="sunset"`, která ukazuje na tuto sekci. Momentálně není nic ve vyřazování.

## Nástroj příkazové řádky

`posty-cli` používá stejné API, jen z terminálu. Instalace a přihlášení:

```
npm install -g posty-cli
posty auth:login
posty integrations:list
```

Přihlášení otevře prohlížeč a klíč uloží na váš počítač, takže ho nemusíte vkládat do skriptů. Každý příkaz umí dát výstup `--json`, který je určený ke strojovému zpracování.

Hitelesítés

| posty auth:login | Böngészős bejelentkezés, a kulcsot a gép tárolja. |
| --- | --- |
| posty auth:status | Melyik munkaterülethez van kötve a gép. |
| posty auth:logout | A tárolt kulcs törlése. |

Csatornák

| posty integrations:list | A bekötött csatornák azonosítóval. |
| --- | --- |
| posty integrations:settings <id> | Egy csatorna szabályai és beállításai. |
| posty integrations:trigger <id> <method> | Platformspecifikus lekérdezés a csatornán. |

Posztolás

| posty posts:create -c "szöveg" --date "..." -i "<id>" | Ütemezett poszt egy vagy több csatornára. |
| --- | --- |
| posty posts:create -c "szöveg" -t draft ... | Ugyanaz piszkozatként, közzététel nélkül. |
| posty posts:create --json fajl.json | A teljes kérés fájlból, szkriptekhez. |

Kezelés

| posty posts:list | A naptár tartalma. |
| --- | --- |
| posty posts:delete <id> | Poszt törlése. |
| posty posts:status <id> --status draft | Váltás piszkozat és ütemezett között. |
| posty posts:find-slot <id> | A következő szabad időpont. |
| posty upload <fajl> | Médiafeltöltés a médiatárba. |
| posty upload:link | Böngészős feltöltési link, ha a fájl nem a gépen van. |
| posty upload:files <id> | Ami a feltöltési linken beérkezett. |

Analitika

| posty analytics:platform <id> -d 30 | Csatornastatisztika az elmúlt N napra. |
| --- | --- |
| posty analytics:post <id> | Egy poszt statisztikái. |
| posty posts:missing <id> | Mi hiányzik még a poszthoz. |

## MCP server

Adresa MCP serveru je `https://api.posty.hu/mcp-oauth`, s přenosem streamable HTTP a autentizací OAuth 2.1. Váš agent vidí tyto nástroje:

| Nástroj | Co dělá | Zapisuje? |
| --- | --- | --- |
| get\_workspace\_context | A pontos idő UTC-ben, a felhasználó időzónája és a munkaterület neve. | ne |
| list\_integrations | A bekötött csatornák azonosítóval, @handle-lel és állapottal. | ne |
| list\_groups | Az ügyfélcsoportok. | ne |
| get\_integration\_schema | Egy csatorna szabályai és a fiókra feloldott karakterkorlát. | ne |
| get\_channel\_options | Platformspecifikus választható értékek egy csatornához. | ano |
| preview\_post | Megmutatja, mi menne ki, csatornánként. Nem ír semmit. | ne |
| list\_posts | A naptár, UTC és helyi idővel, csatornanévvel. | ne |
| delete\_post | Nem közzétett poszt törlése. A már kint lévőt visszautasítja. | ano |
| create\_post | Piszkozat, ütemezés vagy azonnali közzététel. | ano |
| upload\_media\_from\_url | Kép vagy videó a médiatárba URL-ből vagy data URL-ből. | ano |
| create\_upload\_link | Böngészős link, amire a felhasználó ráhúzza a saját gépén lévő fájlt. Két óráig él. | ano |
| list\_upload\_link\_files | Ami a feltöltési linken beérkezett, a posztba tehető címmel. | ne |

Připojení žádá o autentizaci: bez přihlašovacích údajů server vrátí 401 a v hlavičce `WWW-Authenticate` řekne, kde požádat o oprávnění. To není chyba, ale začátek procesu podle standardu MCP. Seznam nástrojů se i tak dá přečíst z [manifestu](https://posty.hu/.well-known/mcp.json).

## Strojově čitelné

Každý dokument, který agent nebo generátor požaduje:

- OpenAPI 3: [https://posty.hu/openapi.json](https://posty.hu/openapi.json)
- MCP manifest: [https://posty.hu/.well-known/mcp.json](https://posty.hu/.well-known/mcp.json)
- Stav a zjištění: `https://api.posty.hu/public/v1/status`
- OAuth metadata: `https://api.posty.hu/.well-known/oauth-protected-resource`
- Krátké shrnutí pro agenty: [https://posty.hu/llms.txt](https://posty.hu/llms.txt)

Začněte ještě dnes

## Získejte publikum, ne další směnu

Posty uspořádá vaše sociální účty do jednoho kalendáře. Zbude vám víc času na zájemce i na podnikání. Ať vám správa účtů nezabere deset hodin týdně.

[Vyzkoušet zdarma](https://posty.hu/regisztracio)

7 dní zdarma · dnes zaplatíte 0 Ft · zrušení kdykoli