Posty fejlesztői erőforrások: API, MCP, OpenAPI, CLI

A Posty ütemezőjét négy programozható felületen éred el: nyilvános REST API, MCP-szerver, parancssori eszköz és webhookok. Mind ugyanazt a fiókot kezeli, ugyanazokkal a jogosultságokkal, amiket a webes felületen látsz. Ez az oldal a hivatkozási pont, a kliensenkénti beállításokat az AI-ügynökök oldal írja le.

Egy pillantásra

Posty developer documentation in English: REST API, MCP server, OpenAPI, CLI

Posty is a Hungarian social media scheduler. It publishes and schedules posts to 12+ social platforms, and it can be driven entirely by a machine through a public REST API, an MCP server or a command line tool. This section is the same reference as the rest of the page, in English, for developers and agents arriving from an English search. The product interface and support are Hungarian.

Getting started is self-serve

• Sign-up: self-serve at https://posty.hu/regisztracio. Registration is free and involves no sales call, no demo request, no waiting list and no manual approval.
• API keys: self-serve. You create them yourself after signing up, inside the app under Beállítások → Fejlesztők (Settings → Developers): an API key for the REST API and the CLI, an MCP key for chat clients. Nobody has to issue one for you, and no sales contact is involved. A key is shown once, at creation.
• Free tier: there is no permanently free publishing plan. Up to 5 channels can be connected before subscribing, so a new account can see its own channels, but nothing is published or scheduled without a plan. Every plan starts with a 7 day free trial. A card is collected when the trial starts, because checkout is a Stripe subscription session, and nothing is charged during the trial.
• Support: [email protected].

Nyilvános REST API

A REST API az https://api.posty.hu címen válaszol, a nyilvános útvonalak pedig a /public/v1 előtag alatt vannak. Ugyanazt a munkaterületet kezeli, mint a webes felület, csak közvetlenül a kódodból.

Hitelesítés

Minden kérés egy API-kulcsot visz az Authorization fejlécben. A kulcsot a Postyban, a Beállítások → Fejlesztők oldalon hozod létre, ehhez nem kell hozzánk írnod. A kulcs a létrehozás pillanatában egyszer látszik, utána már nem kérdezhető vissza, ezért mentsd el rögtön. A kulcsok szűkíthetők: a jogosultságuk a tulajdonos aktuális szerepkörével együtt mozog, és a munkaterületről kikerülő felhasználó kulcsa megszűnik működni.

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

Amit a v1 tud

• Bekötött közösségi fiókok listázása: GET https://api.posty.hu/public/v1/integrations
• Poszt létrehozása és ütemezése: POST https://api.posty.hu/public/v1/posts
• Naptár lekérdezése, módosítás, törlés: GET https://api.posty.hu/public/v1/posts, DELETE https://api.posty.hu/public/v1/posts/:id
• Médiafeltöltés fájlból vagy URL-ből: POST https://api.posty.hu/public/v1/upload, POST https://api.posty.hu/public/v1/upload-from-url
• Böngészős feltöltési link, ha a fájl a felhasználó eszközén van: POST https://api.posty.hu/public/v1/upload-link, GET https://api.posty.hu/public/v1/upload-link/:id
• Következő szabad időpont keresése: GET https://api.posty.hu/public/v1/find-slot/:id
• Statisztikák csatornára és posztra: GET https://api.posty.hu/public/v1/analytics/:integration

Állapot és felderítés hitelesítés nélkül

A GET https://api.posty.hu/public/v1/status az egyetlen útvonal, amely kulcs nélkül is válaszol. Megadja az API verzióját, a szerver pontos idejét UTC-ben, és abszolút címmel minden gépi olvasásra szánt dokumentumot: az OpenAPI-leírást, az OAuth-metaadatokat, az MCP-végpontot. Munkaterületi adatot nem ad vissza, és paramétert sem fogad. Egy ügynök ezzel tudja a leggyorsabban eldönteni, hogy elér-e minket, és hol keresse a többit.

Hibák

Minden hiba JSON-t ad vissza. A Posty által kiváltott hibákban a msg mező hordozza az emberi mondatot; a kérés formai ellenőrzésén elbukó hívások a keretrendszer alakját kapják (statusCode, message, error). A jogosultsági 403 megnevezi a hiányzó scope-ot és a kulcs tulajdonosának aktuális szerepkörét, mert a leggyakoribb ok nem a rosszul létrehozott kulcs, hanem a lefokozott felhasználó. Az OpenAPI dokumentum ApiError sémája mindezt géppel olvashatóan leírja, státuszkódonként azzal együtt, hogy érdemes-e újrapróbálni.

Hívási korlátok

Minden válasz viszi a RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (másodpercben) és RateLimit-Policy fejléceket, útvonalanként külön kerettel. A 429 mellé Retry-After is érkezik. Ne a 429-re várj: a maradék értékből előre tudsz lassítani.

Verziózás és kivezetés

A verzió az útvonalban van, minden nyilvános hívás a /public/v1 alatt él. Törő változás új verzióként jelenne meg (/public/v2), a v1 pedig tartja a szerződését. Bővítés (új opcionális mező, új útvonal, új felsorolt érték) a v1-en belül történik, ezért az ügyfélkódod hagyja figyelmen kívül azokat a mezőket, amelyeket nem ismer.

Ha egy útvonalat kivezetnénk, a válasza Deprecation: true fejlécet kap, mellette Sunset fejlécben azzal a dátummal, ami után már nem működik, és egy Link fejlécben a részletekkel. A Sunset dátum soha nem lehet közelebb 180 napnál az első Deprecation fejléctől számítva. Jelenleg semmi nincs kivezetés alatt.

MCP-szerver

Az MCP-szerver címe https://api.posty.hu/mcp, streamable HTTP átvitellel. Az ügynököd ezen keresztül ugyanazokat a csatornákat látja és ugyanabba a naptárba ütemez, mint te.

• Kulcs kliensekhez: psty_mcp_… kezdetű MCP-kulcs, a Beállítások → Fejlesztők oldalról. A psty_… kezdetű REST-kulcsokat az MCP-szerver szándékosan visszautasítja, és meg is mondja, miért.
• Kulcs alkalmazásokhoz: pos_… kezdetű OAuth hozzáférési token. Ez lejár, frissíthető, és csak arra a címre érvényes, amelyre kiállították.
• Kész beállítási blokkot a Claude, a ChatGPT, a Muse, a Hermes és az OpenClaw kliensekhez a Beállítások → Fejlesztők oldalon másolsz ki, a leírásuk pedig az AI-ügynökök oldalon van.

Parancssori eszköz

A posty-cli csomag az npm-en van kiadva. Telepítés: npm install -g posty-cli, a parancs neve pedig posty. Belépés böngészős jóváhagyással: posty auth:login.

A csomagban ott van a SKILL.md, amely minden parancsot és kapcsolót leír. Egy ügynök, amelynek van shellje, ebből tanulja meg a használatot, weboldal olvasása nélkül. A CLI a JSON-választ a szabványos kimenetre, az állapotot és a hibákat a hibakimenetre írja, sikertelen futásnál pedig nem nullával lép ki, így a hívó program tudja, mi történt.

Webhookok

A webhookokat a Postyban állítod be, és minden kézbesítés alá van írva. Az aláírás az X-Posty-Signature fejlécben érkezik, t=<unix másodperc>,v1=<hex hmac-sha256> alakban. Ez szándékosan ugyanaz a forma, mint a Stripe aláírása, így a meglévő ellenőrző könyvtárak működnek vele.

• Az aláírás a nyers kéréstörzsre készül. Ha a kereted előbb JSON-ra alakítja és újra sorosítja, más karakterláncot kapsz, és az ellenőrzés elbukik.
• Az időbélyeg az aláírás része, ez a visszajátszás elleni védelem. A tűréshatár 300 másodperc.
• Az aláíró titkot a webhook létrehozásakor kapod meg, és a Postyban bármikor újragenerálhatod.

OAuth-alkalmazások

Ha nem a saját fiókodat kezeled, hanem másokét egy alkalmazásból, OAuth-ot használsz. Az engedélyezés authorization code folyamattal megy, és a következők kötelezőek.

• PKCE S256 kihívás minden kérésnél. Titok nélküli kliens is regisztrálható, de PKCE nélkül nem.
• A redirect_uri pontos egyezés a regisztrált listával.
• A tokenek lejárnak, a frissítő tokent pedig rotáljuk. Csak a hasított formájukat tároljuk.
• A token azokra a scope-okra jó, amikhez a felhasználó hozzájárult, és ezt minden híváskor metszük a felhasználó aktuális szerepkörével. Egy visszaminősítés a következő híváson érvényesül.
• Alkalmazást a munkaterület SUPERADMIN szerepű tagja engedélyezhet.

Hozzáférés és első lépések

A folyamat végig önkiszolgáló, nem kell hozzá értékesítővel beszélned és nem kell demót kérned.

• Regisztrálsz a /regisztracio oldalon. A regisztráció ingyenes.
• Bekötöd a közösségi fiókjaidat a szokásos OAuth-folyamattal.
• Kulcsot készítesz a Beállítások → Fejlesztők oldalon: API-kulcsot a REST API-hoz és a CLI-hez, MCP-kulcsot a chatklienshez.
• Minden csomag 7 napos ingyenes próbával indul. A próba indításához bankkártyát kérünk, de a próba alatt nem vonunk le semmit, ma 0 Ft fizetendő, és a vége előtt bármikor lemondhatod. Az árakat az árak szakasz mutatja.

Gépi olvasásra

Ha ügynököt írsz, ne HTML-t elemezz. A honlap minden nyilvános oldalának van Markdown változata: tedd a .md végződést az útvonal végére, a főoldal pedig /index.md.

Ha elakadsz

Írj a [email protected] címre, vagy használd a Segítség oldal űrlapját. Munkanapokon általában egy napon belül válaszolunk.