API: autentifikácia

Verejné REST endpointy (/api/v1/…) sa autentifikujú API kľúčom v hlavičke:

Authorization: Bearer kw_live_…

Kľúč vytvára administrátor v sekcii API kľúče a má jeden rozsah:

Zápis dokumentov: viazaný na jeden priečinok; posiela, vypisuje a maže dokumenty (Dokumenty).
Otázky: viazaný na jeden asistent; kladie otázky a vracia odpovede (Otázky). Súčasť balíka Growth.

Neplatný, zneplatnený alebo expirovaný kľúč vráti 401. Použitie kľúča na nesprávnom type endpointu vráti 403.

Overenie kľúča

GET /api/v1/me
Authorization: Bearer kw_live_…

Vráti rozsah kľúča (priečinok alebo asistent), stav a platnosť, bez volania AI, takže integráciu si overíte ešte pred prvým ostrým volaním.