Vërtetimi

Hyrja, rinovimi i token-it, rivendosja e fjalëkalimit, përfundimi i SSO – dhe qasja API me çelës API.

Ky grup përfshin identifikimin e përdoruesve: hyrjen me adresën e e-mailit ose emrin e përdoruesit dhe fjalëkalimin, rinovimin e sesionit me refresh-token, rivendosjen e një fjalëkalimi të harruar dhe përfundimin e një hyrjeje me identifikim të njëhershëm (SAML/OIDC). Endpoint-et kthejnë një token aksesi (JWT), i cili dërgohet në header-in `Authorization: Bearer <token>`, dhe një refresh-token, i cili zëvendësohet me një të ri në çdo përdorim.

Për qasje të makinerishme të programeve tuaja në të dhënat tuaja, në vend të identifikimit të përdoruesit, përdorni një çelës API për REST API-n te `https://zentor-app.de/api/v1`. Zentor e aktivizon qasjen API me kërkesë; pastaj administratorët krijojnë në panelin e kontrollit te „Çelësat API“ çelësa me leje të caktuara (scope). Çelësi transmetohet në header-in `Authorization: Bearer <çelësi API>` ose `X-API-Key`. Scope-et, kodet e gabimeve dhe këshillat për ruajtjen e sigurt gjenden në përmbledhjen e referencës API.

Endpoint-et e identifikimit janë të mbrojtur nga përpjekjet e përsëritura të dështuara: pas disa futjeve të gabuara, serveri vonon përpjekjet e mëtejshme dhe i blokon përkohësisht me 429 `RATE_LIMIT_EXCEEDED`.

POST/api/auth/loginPOST/api/auth/refreshPOST/api/auth/forgot-passwordPOST/api/auth/reset-passwordPOST/api/auth/sso/exchange
← Referenca API