Autentizace

Veřejné REST API používá Bearer JWT token. Token se získává pomocí API credential páru client_id a client_secret.

Tok

sequenceDiagram
  participant Client as Klientský systém
  participant API as Knowspread REST API
  participant Space as CompanySpace credential

  Client->>API: POST /rest/v1/auth/token
  API->>Space: Ověří client_id a client_secret
  Space-->>API: company_space_id
  API-->>Client: access_token + expires
  Client->>API: Authorization: Bearer access_token

Důležité vlastnosti

• Token je vázaný na company_space_id.
• Expirace je konfigurovatelná přes JWT_TOKEN_EXPIRY_IN_MINUTES.
• Všechny ostatní REST endpointy očekávají validní Bearer token.
• Token nenahrazuje doménové validace. Endpoint pořád kontroluje, jestli požadovaný zdroj patří do company space.

Pro dokumentaci doplnit

• přesný request a response příklad,
• chybové stavy pro neplatné credentials,
• doporučený refresh/retry pattern pro integrátory.