---
title: "Hitelesítés és jogosultságok | Posty dokumentáció"
description: "API-kulcs, MCP-kulcs, OAuth-token: melyik mire való, hogyan készíted el, és mit jelentenek a scope-ok."
canonical: https://posty.hu/cs/dokumentace/api/overeni
source: https://posty.hu/cs/dokumentace/api/overeni.md
---

Nyilvános API

# Hitelesítés és jogosultságok

API-kulcs, MCP-kulcs, OAuth-token: melyik mire való, hogyan készíted el, és mit jelentenek a scope-ok.

## Tři přihlašovací údaje

| Typ | Předpona | Kde ho používáte | Odkud je |
| --- | --- | --- | --- |
| API klíč | `psty_…` | REST API a nástroj příkazového řádku | Nastavení → Vývojáři |
| MCP klíč | `psty_mcp_…` | MCP server, pro chatovací klienty | Nastavení → Vývojáři |
| OAuth token | `pos_…` | Když aplikace přistupuje jménem ostatních | Na konci procesu OAuth |

REST klíč a MCP klíč nelze zaměnit

Na MCP serveru záměrně odmítáme REST klíč začínající na `psty_` a uvedeme i proč. Pokud se chatovací klient nemůže připojit, je to nejčastější příčina.

## API klíč

Klíč vytvoříte v Posty na stránce Nastavení → Vývojáři. Nemusíte nám nic psát a není tu žádné schvalování. Klíč se zobrazí jen jednou, v okamžiku vytvoření. Později ho už nelze zobrazit.

Každý požadavek posílá klíč v hlavičce `Authorization`. Klíč je **celá** hodnota hlavičky:

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

Kód másolása

U tokenu OAuth je naopak předpona `Bearer`:

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

Kód másolása

## Oprávnění

Klíč můžete omezit: povolíte mu jen operace, které opravdu potřebuje. To jsou scope a vypisuje je i odpověď z `https://api.posty.hu/public/v1/status`.

| Scope | Co povoluje |
| --- | --- |
| `posts:read` | Čtení kalendáře a příspěvků. |
| `posts:draft` | Vytváření, úpravy a mazání konceptů. |
| `posts:publish` | Plánování a okamžité publikování a také přesun z konceptu. |
| `channels:read` | Čtení kanálů, skupin a schémat nastavení. |
| `channels:write` | Zahájení propojení kanálu. |
| `media:write` | Nahrání do knihovny médií. |
| `analytics:read` | Čtení statistik. |

U MCP jsou dva scope: `mcp:read` a `mcp:write`.

Dejte co nejméně

Agentovi, který tvoří koncepty, stačí `posts:read` a `posts:draft`. Když se pak něco nepovede, nejhorší, co se stane, je zbytečný koncept, ne příspěvek, který šel ke skutečnému publiku.

## Výběr pracovního prostoru

Pokud klíč patří k více pracovním prostorům, hlavička `showorg` vybere, kterého se volání týká:

```
curl https://api.posty.hu/public/v1/integrations \
  -H "Authorization: psty_a_kulcsod" \
  -H "showorg: <munkaterulet-azonosito>"
```

Kód másolása

## 401 a 403

| Kód | Co to znamená | Co udělat |
| --- | --- | --- |
| 401 | Přihlašovací údaj chybí, je špatný, vypršel nebo byl zrušen. | Zkontrolujte, že klíč je celá hodnota hlavičky Authorization, bez Bearer, a že jste ho mezitím nevyměnili. |
| 403 | Autentizace je v pořádku, ale oprávnění nestačí. | Odpověď uvede chybějící scope a aktuální roli vlastníka klíče. Podívejte se na obojí. |

403 se nejčastěji týká uživatele

Oprávnění klíče se řídí aktuální rolí jeho vlastníka. Když někoho přeřadí na nižší roli nebo ho odeberou z pracovního prostoru, jeho klíč umí hned jen to, co smí on. Když klíč, který včera ještě fungoval, dnes vrátí 403, je to téměř vždy právě tohle.

## Správa klíčů

- Uložte ho do proměnné prostředí nebo do správce tajemství, ne do kódu a ne do verzovacího systému.
- Když se dostal někam, kam neměl, vyměňte ho na stránce Nastavení → Vývojáři. Výměna platí okamžitě. Starý klíč dostane při dalším volání 401.
- U nástroje příkazového řádku klíč ani kopírovat nemusíte: `posty auth:login` uloží přihlašovací údaj ve vašem počítači. Viz stránku [Autentizace CLI](https://posty.hu/cs/dokumentace/cli/overeni).
- API klíč nám nikdy neposílejte e-mailem. Nepotřebujeme ho.

Stránky dokumentace

Něco vám na této stránce chybí? Napište na [norbert@posty.hu](mailto:norbert@posty.hu) nebo na stránce [Nápověda](https://posty.hu/cs/napoveda) vyplňte formulář.