Endpointy API
Všechny endpointy API
Úplný seznam endpointů veřejného REST API s metodou, cestou a potřebným oprávněním.
Kompletní seznam
Každá cesta je pod https://api.posty.hu/public/v1. Klikněte na název pro podrobný popis, s parametry a spustitelným příkladem.
| Metoda | Cesta | Co dělá | Oprávnění |
|---|---|---|---|
| GET | /status | Stav a zjišťování. Odpovídá i bez klíče. | |
| POST | /signup/start | Pošle jednorázový kód na e-mailovou adresu uživatele. Lze volat bez klíče a pro každou adresu vrací stejnou odpověď. | |
| POST | /signup/complete | S kódem a souhlasem uživatele (acceptTerms: true) vytvoří účet a jednou zobrazí úplný klíč pracovního prostoru (psty_sa_). Zkušební období zdarma není, dalším krokem je checkout. 409, pokud k adrese už účet existuje. | |
| GET | /is-connected | Ověří, zda klíč ukazuje na platný pracovní prostor. | |
| GET | /workspaces | Pracovní prostory, na které klíč dosáhne. `current` označuje ten, na který dotaz přišel. Pokud klíč platí pro více pracovních prostorů, ostatní cesty očekávají ID pracovního prostoru v hlavičce `showorg`. | |
| GET | /integrations | Připojené kanály: ID, název, @handle, platforma a zda kanál může právě publikovat. | channels:read |
| GET | /integration-settings/:id | Pravidla publikování a schéma nastavení kanálu, s limitem znaků platným pro daný účet. | channels:read |
| POST | /integration-trigger/:id | Dotaz specifický pro platformu na kanálu: seznamy nástěnek, subredditů, stránek. | channels:read |
| GET | /social/:integration | Vrátí adresu platformy, kterou musí člověk otevřít, aby kanál připojil. | channels:write |
| GET | /groups | Skupiny zákazníků, do kterých jsou kanály zařazeny. | channels:read |
| GET | /posts | Kalendář za dané období: každý příspěvek se stavem a časem. | posts:read |
| POST | /posts | Vytvoří příspěvek: koncept, naplánovaný nebo okamžitě publikovaný, na jeden či více kanálů. | posts:draft (pro publikování také posts:publish) |
| DELETE | /posts/:id | Smaže jen tento jeden příspěvek (jeden kanál) s jeho vláknem. Ostatní kanály skupiny zůstanou. | posts:draft |
| DELETE | /posts/group/:group | Smaže celou skupinu na všech kanálech: jednu úpravu odeslanou na více kanálů. | posts:draft |
| PUT | /posts/:id/status | Přesune příspěvek mezi stavem konceptu a naplánovaným stavem. | posts:publish |
| GET | /posts/:id/missing | Řekne, co příspěvku ještě chybí k publikování. | posts:read |
| PUT | /posts/:id/release-id | Zaznamená ID a adresu příspěvku, který byl publikován mimo platformu. | posts:publish |
| GET | /find-slot/:id | Nejbližší volný termín podle plánu pracovního prostoru. | posts:read |
| POST | /upload | Nahraje obrázek nebo video do knihovny médií, nejvýše 1 GB. | media:write |
| POST | /upload-from-url | Stáhne mediální soubor z veřejné adresy URL do knihovny médií. | media:write |
| POST | /upload-link | Odkaz pro nahrání v prohlížeči, když je soubor v zařízení uživatele. | media:write |
| GET | /upload-link/:id | Soubory přijaté přes odkaz pro nahrání, s adresou, kterou lze vložit do příspěvku. | media:write |
| GET | /analytics/:integration | Statistiky kanálu za požadované období. | analytics:read |
| GET | /analytics/post/:postId | Statistiky publikovaného příspěvku z platformy. | analytics:read |
| GET | /notifications | Oznámení pracovního prostoru, po stránkách. | posts:read |
| GET | /fotoai/status | Zda je připojen účet FotoAI vlastníka klíče, pod kým, a zůstatek kreditů FotoAI. | media:write |
| GET | /fotoai/models | Obrazové a video modely FotoAI s parametry (poměr stran, rozlišení, délka) a cenou v kreditech. | media:write |
| POST | /fotoai/quote | Přesná cena generování a quote_id platné 10 minut. Nic neutratí. | media:write |
| POST | /fotoai/generations | Spustí generování z kreditů FotoAI uživatele, s cenovým stropem (max_millicredits nebo quote_id) a klíčem idempotence. Výsledek jde do knihovny médií. | media:write |
| GET | /fotoai/generations | Nedávná generování FotoAI uživatele ze všech zdrojů, označená, pokud už jsou v knihovně médií tohoto pracovního prostoru. | media:write |
| GET | /fotoai/generations/:id | Stav generování; po dokončení obrázky a videa uložené v knihovně médií s adresou pro příspěvek. | media:write |
| POST | /fotoai/generations/:id/import | Importuje libovolné generování FotoAI (i vytvořené na fotoai.hu) do knihovny médií. Druhý import vrátí stejná média. | media:write |
| GET | /plans | Čtyři tarify (Alap, Pro, Kreátor, Csapat) s měsíční a roční cenou ve forintech, eurech, švýcarských francích a amerických dolarech, hlavní limity, pravidlo zkušebního období a aktuální tarif pracovního prostoru. Odpovídá bez omezení tarifem. | |
| GET | /subscription | Stav předplatného, které řídí pracovní prostor (none, trialing, active, past_due, read_only, cancelled), tarif, konec období a nezaplacený checkout zahájený za poslední hodinu. Zjistěte to po zaplacení. | |
| POST | /subscriptions/checkout | Odkaz na Stripe Checkout pro zvolený tarif a období. Nic nestrhne: uživatel odkaz otevře a zaplatí vlastní peněženkou Link nebo kartou. Volat ho může jen token OAuth nebo úplný klíč pracovního prostoru (psty_sa_) plátce. | |
| GET | /subscription/portal | Krátkodobý odkaz na fakturační portál Stripe: změna tarifu, zrušení, faktury, karta. Stejné pravidlo ověření jako u checkoutu. |
Jak to číst
Sloupec „Oprávnění“ ukazuje, jaký scope klíč potřebuje. Když chybí, odpověď je 403. Uvede chybějící scope a aktuální roli vlastníka klíče. Seznam scope najdete na stránce Autentizace.
Dvě cesty, /status a /is-connected, scope nepotřebují. Ta první nepotřebuje ani autentizaci.
Přesná schémata
Tyto stránky popisují použití, s příklady. Strojově čitelné schéma, pole po poli, je v dokumentu OpenAPI 3 a z něj si můžete nechat vygenerovat i kód klienta.
Chybové odpovědi a limity volání najdete na stránce Chyby a limity.
Něco vám na této stránce chybí? Napište na [email protected] nebo na stránce Nápověda vyplňte formulář.