---
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/dokumentacio/api
source: https://posty.hu/dokumentacio/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.

## Alapadatok

Alapcím

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

Verzió

Az útvonalban: /public/v1

Hitelesítés

API-kulcs a teljes `Authorization` fejlécként, vagy OAuth 2.1 hozzáférési token

Formátum

Minden kérés és válasz JSON

Dátumok

ISO 8601, mindig UTC

OpenAPI 3

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

Elérhetőség

A Pro csomagtól. Lásd a [Csomagok](https://posty.hu/dokumentacio/csomagok) oldalt.

## Az első hívás

A `/status` az egyetlen útvonal, amely kulcs nélkül is válaszol. Ezzel tudod a leggyorsabban eldönteni, hogy elérsz-e minket, és megkapod belőle minden más dokumentum címét:

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

Kód másolása

Az első hitelesített hívás pedig a csatornáidat listázza:

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

Kód másolása

Nincs Bearer előtag az API-kulcs előtt

Az API-kulcs a `Authorization` fejléc **teljes** értéke, `Bearer` nélkül. A `Bearer` előtag az OAuth-tokenhez tartozik. Ez a leggyakoribb ok, amiért egy első hívás 401-et kap.

A kulcsot magad készíted a Postyban; lásd a [Hitelesítés](https://posty.hu/dokumentacio/api/hitelesites) oldalt.

## Mit tud a v1

Az API ugyanazt a munkaterületet kezeli, mint a webes felület. Egyetlen dolgot nem tud: csatornát bekötni, mert azt a platform egy embertől kéri.

[Csatornák — Listázás, beállítássémák, platformspecifikus lekérdezések.](https://posty.hu/dokumentacio/api/vegpontok/csatornak)[Bejegyzések — Létrehozás, ütemezés, azonnali közzététel, naptár, törlés.](https://posty.hu/dokumentacio/api/vegpontok/bejegyzes-letrehozas)[Média — Feltöltés fájlból vagy nyilvános URL-ről.](https://posty.hu/dokumentacio/api/vegpontok/media-feltoltes)[Analitika — Csatorna- és bejegyzésstatisztika.](https://posty.hu/dokumentacio/api/vegpontok/csatorna-statisztika)

A teljes listát a [Végpontok](https://posty.hu/dokumentacio/api/vegpontok) oldalon találod, minden végponthoz külön oldallal.

## A kérés és a válasz alakja

Minden törzs JSON, és minden dátum ISO 8601 UTC. A hibák is JSON-ok; az alakjukat és a hívási korlátokat a [Hibák és korlátok](https://posty.hu/dokumentacio/api/hibak) oldal írja le.

Ha egy kulcs több munkaterülethez tartozik, a `showorg` fejléc választja ki, melyikre vonatkozik a hívás.

## Gépi leírás

OpenAPI 3

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

MCP manifeszt

[https://posty.hu/.well-known/mcp.json](https://posty.hu/.well-known/mcp.json)

Ügynököknek szóló összefoglaló

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

OAuth metaadatok

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

Ez az oldal Markdownban

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

Az OpenAPI dokumentumból klienskódot is tudsz generáltatni, és minden scope neve benne van a `components.securitySchemes` alatt.

## Tovább

[Hitelesítés — Kulcsok, scope-ok, munkaterület-választás.](https://posty.hu/dokumentacio/api/hitelesites)[Hibák és korlátok — Hibaalakok, újrapróbálkozás, RateLimit fejlécek, verziózás.](https://posty.hu/dokumentacio/api/hibak)[OAuth 2.1 — Ha mások fiókját kezelnéd a saját alkalmazásodból.](https://posty.hu/dokumentacio/api/oauth)[Webhookok — A fordított irány: értesítjük a rendszeredet.](https://posty.hu/dokumentacio/automatizalas/webhookok)

Dokumentációs oldalak

Hiányzik valami erről az oldalról? Írj a [norbert@posty.hu](mailto:norbert@posty.hu) címre, vagy használd a [Segítség](https://posty.hu/segitseg) oldal űrlapját.