---
title: "A nyilvános REST API | Posty dokumentáció"
description: "Alapcím, első hívás, a kérés és a válasz alakja, és hol van a gépi leírás."
canonical: https://posty.hu/cs/dokumentace/api
source: https://posty.hu/cs/dokumentace/api.md
---

Nyilvános API

# A nyilvános REST API

Alapcím, első hívás, a kérés és a válasz alakja, és hol van a gépi leírás.

## Základy

Základní URL

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

Verze

V cestě: /public/v1

Autentizace

API klíč jako celá hlavička `Authorization`, nebo přístupový token OAuth 2.1

Formát

Každý požadavek i každá odpověď je JSON

Datumy

ISO 8601, vždy UTC

OpenAPI 3

[https://posty.hu/openapi.json](https://posty.hu/openapi.json)

Dostupnost

Od tarifu Pro. Viz stránku [Tarify](https://posty.hu/cs/dokumentace/tarify).

## První volání

`/status` je jediná cesta, která odpoví i bez klíče. Tím nejrychleji ověříte, že se k nám dostanete, a z odpovědi získáte adresy všech ostatních dokumentů:

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

Kód másolása

První autentizované volání vypíše vaše kanály:

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

Kód másolása

Před API klíčem žádná předpona Bearer

API klíč je **celá** hodnota hlavičky `Authorization`, bez `Bearer`. Předpona `Bearer` patří k tokenu OAuth. To je nejčastější důvod, proč první volání vrátí 401.

Klíč si vytvoříte sami v Posty. Viz stránku [Autentizace](https://posty.hu/cs/dokumentace/api/overeni).

## Co umí v1

API spravuje stejný pracovní prostor jako webové rozhraní. Jediné, co neumí, je propojit kanál, protože to platforma vyžaduje od člověka.

[Kanály — Výpis, schémata nastavení, dotazy specifické pro platformu.](https://posty.hu/cs/dokumentace/api/koncove-body/csatornak)[Příspěvky — Vytvoření, plánování, okamžité publikování, kalendář, smazání.](https://posty.hu/cs/dokumentace/api/koncove-body/bejegyzes-letrehozas)[Média — Nahrání ze souboru nebo z veřejné URL.](https://posty.hu/cs/dokumentace/api/koncove-body/media-feltoltes)[Analytika — Statistiky kanálů a příspěvků.](https://posty.hu/cs/dokumentace/api/koncove-body/csatorna-statisztika)

Kompletní seznam najdete na stránce [Koncové body](https://posty.hu/cs/dokumentace/api/koncove-body). Ke každému koncovému bodu je vlastní stránka.

## Tvar požadavku a odpovědi

Každé tělo je JSON a každé datum je ISO 8601 UTC. Chyby jsou také JSON. Jejich tvar a limity volání popisuje stránka [Chyby a limity](https://posty.hu/cs/dokumentace/api/chyby).

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

## Strojově čitelný popis

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)

Shrnutí pro agenty

[https://posty.hu/llms.txt](https://posty.hu/llms.txt)

OAuth metadata

`https://api.posty.hu/.well-known/oauth-protected-resource`

Tato stránka v Markdownu

[https://posty.hu/dokumentacio/api.md](https://posty.hu/dokumentacio/api.md)

Z dokumentu OpenAPI si můžete nechat vygenerovat i kód klienta. Názvy všech scope jsou v něm pod `components.securitySchemes`.

## Co dál

[Autentizace — Klíče, scope, výběr pracovního prostoru.](https://posty.hu/cs/dokumentace/api/overeni)[Chyby a limity — Tvary chyb, opakování, hlavičky RateLimit, verzování.](https://posty.hu/cs/dokumentace/api/chyby)[OAuth 2.1 — Když chcete z vlastní aplikace spravovat účty ostatních.](https://posty.hu/cs/dokumentace/api/oauth)[Webhooky — Opačný směr: my upozorníme váš systém.](https://posty.hu/cs/dokumentace/automatizace/webhooky)

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ář.