Fenice Api
Auth autenticazione al sistema
Consente ad un sistema abilitato da BASE ad interagire con le API.
Un token ha una durata di 24 ore. Al suo termine invalida altre richieste e sessioni.
POST authapi/authorize_api

Info: autenticazione al sistema. Esso richiede code e key fornite, dalla sezione Fenice Base.
Parametro in header: code codice fornito da Fenice BASE
Parametro in header: key codice fornito da Fenice BASE. Questa informazione non è conservata dal sistema. In caso di problemi deve essere rigenerata.

Descrizione: la chiamata con in corretti parametri consente di ottenere un valore token da associare alle chiamate successive.

200 OK Esempio di risposta positiva (in JSON):
{ "token": { "payload": { "exp": 1771335133, "sub": 1 }, "token": "••••••[qui il Token JWT in formato stringa, da usare per le prossime chiamate di cui si richiede autorizzazione]" } }

401 Unauthorized Esempio di risposta negativa (in JSON):
{ "error": "Invalid authentication" }

404 Bad Request Esempio di richiesta errata o parametri errati o assenti (in JSON):
{ "error": "Bad request" }


POST authapi/sign_out_api

Termina autenticazione al sistema. Esso non richiede parametri

Descrizione: la chiamata richiede header con codice JWC valido. Il codice 'Authorization: Bearer eyJ0eXAiOi....' è di esempio e valido per 24 ore.

200 OK Esempio di risposta positiva (in JSON):
{ "info": "Sign out", "lang": "en", "timestamp": "2026-02-16 14:45:01 +0100" }

401 Unauthorized Esempio di risposta negativa (in JSON):
{ "error": "Invalid authentication" }