REST API: API-kulcsok és jogosultságok

A REST API-val programból küldhetsz be ötletet, lekérheted a következő posztokat és a heti tervet, vagy piszkozatot hozhatsz létre. A hitelesítés API-kulccsal megy: minden kérés fejlécében Authorization: Bearer <kulcs>.

Mielőtt elkezded

• API-kulcsot csak a munkatér tulajdonosa hozhat létre és vonhat vissza.
• A Solo csomagban a kulcsok csak olvashatnak; írni Pro vagy nagyobb csomaggal lehet. Ha a próbaidő lejárt vagy az előfizetés nem aktív, a kulcs csak olvas.

Kulcs létrehozása

1. 1Nyisd meg a Beállítások → Összes integráció oldalt, és kattints a REST API kártyára.
2. 2Írd be, mire használod (a mező súgója: Mire? (pl. Zapier)).
3. 3Kattints az Új kulcs gombra.
4. 4Másold ki a kulcsot a Másolás gombbal – csak most látod (API-kulcs (csak most látod):).

Az itt készült kulcs olvasni és írni tud (piszkozat, ötlet), jóváhagyni nem. Ha a jogosultságokat magad választanád ki, a Claude & ChatGPT (MCP) kártyán az API-kulcsok jogosultsággal résznél pipáld be őket, majd kattints a Kulcs létrehozása gombra.

Jogosultságok

• read – márkák, csatornák, terv, posztok, ötletek, naptár-összefoglaló, statisztika.
• write – piszkozat írása és szerkesztése, ötlet, hét generálása, el nem küldött poszt törlése.
• approve – jóváhagyás, vagyis valódi ütemezés. Ehhez a munkatérben is engedélyezni kell a Jóváhagyás asszisztensből kapcsolót, és minden jóváhagyási szabály érvényes.

Gyakori végpontok

Ötlet beküldése: POST /api/v1/ideas {"text":"…"} · következő posztok: GET /api/v1/posts?days=14 · heti terv: GET /api/v1/week. A teljes lista, a hibakódok és a percenkénti korlátok a fejlesztői oldalon vannak.

Kulcs visszavonása

1. 1Nyisd meg a REST API kártyát.
2. 2A kulcs sorában kattints a Visszavonás gombra, és erősítsd meg. Minden, ami a kulcsot használja, azonnal leáll.