Příkazový řádek (CLI)

Autentizace v CLI

Přihlášení v prohlížeči přes device flow, nebo API klíč v proměnné prostředí.

Kterou metodu zvolit

Situace	Metoda
Vlastní počítač s prohlížečem.	`posty auth:login`
Server, kontejner, naplánovaný běh, CI.	`POSTY_API_KEY` proměnná prostředí

Přihlášení v prohlížeči

posty auth:login

Příkaz otevře prohlížeč, kde kódem schválíte přístup. CLI pak přihlašovací údaje uloží na váš počítač, takže je nemusíte vkládat do skriptů a nedostanou se do historie příkazů.

Schvalovací stránka se otevře i bez přihlášení

Je to záměr. Kdo není přihlášený, nejdřív uvidí, co schvaluje, které zařízení a který kód, a teprve potom se přihlásí. Bez přihlášení ke schválení nedojde.

API klíč z proměnné prostředí

Pokud nemáte prohlížeč, zadejte API klíč do proměnné prostředí. Klíč vytvoříte v Posty na stránce Automatizace → Vývojáři. Viz stránku Nastavení pro vývojáře.

export POSTY_API_KEY=psty_vas_klic
posty integrations:list

Pokud je uložené přihlášení, má přednost před proměnnou prostředí.
Klíč předejte ze správce tajemství. Nevkládejte ho do skriptu a neukládejte ho do verzovacího systému.
U naplánovaných běhů se vyplatí nastavit i proměnnou POSTY_TIMEZONE, aby byla data jednoznačná.

Stav a odhlášení

posty auth:status   # ke kterému pracovnímu prostoru je počítač připojený
posty auth:logout   # smazání uložených přihlašovacích údajů

auth:status nejen vypíše stav. Přihlašovací údaje ověří i skutečným voláním. Pokud to projde, je ověření v pořádku. Každá další chyba už se týká samotného příkazu.

Pracovní prostory

posty workspaces:list        # na co klíč dosáhne; "current" je aktivní
posty workspaces:use <id>    # od teď každý příkaz pracuje tam
posty workspaces:current     # ve kterém příkazy pracují teď
posty posts:list --workspace <id>   # jeden příkaz v jiném pracovním prostoru

Klíč může dosáhnout na jeden nebo více pracovních prostorů: „Všechny moje pracovní prostory“ na schvalovací stránce povolí ostatní. ID kanálů patří k pracovnímu prostoru, proto musí příkazový řádek vědět, který máte na mysli. auth:login se zeptá, když klíč pokrývá více prostorů; volba se uloží spolu s přihlášením, POSTY_WORKSPACE a --workspace ji přebíjejí. Bez volby API odmítne víceprostorový klíč s 403 na každé cestě kromě workspaces:list, takže se nikdy nepostuje do odhadnutého prostoru.

Vlastní backendový server

Ve výchozím nastavení se CLI připojuje ke službě posty.hu. Pokud se chcete připojit k jiné instanci, přepnete to přepínačem --auth-server nebo proměnnou POSTY_API_URL.

export POSTY_API_URL=https://sajat-peldany.example/api
posty auth:login --auth-server https://sajat-peldany.example/api

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