Autenticazione

Autenticazione

L'API accetta due metodi. Il token API personale è adatto a script e integrazioni; il JWT alle applicazioni in cui una persona accede con e-mail e password.

Token API personale

1. Aprite API e Integrazione.
2. Cliccate su Genera token API.
3. Copiate il token e inviatelo nell'intestazione Authorization di ogni richiesta:

curl -H "Authorization: Token IL_VOSTRO_TOKEN" https://votre-nom.altiusforms.com/api/v1/forms/

Il token agisce a vostro nome, con i vostri diritti: tenetelo segreto. Ruota token ne crea uno nuovo e invalida subito il precedente; Revoca token lo elimina. In entrambi i casi, le integrazioni che usavano il vecchio token smettono di funzionare finché non vengono aggiornate.

JWT: e-mail e password

1. Richiedete una coppia di token:

curl -X POST https://votre-nom.altiusforms.com/api/v1/token/ -H "Content-Type: application/json" -d '{"email": "voi@esempio.ch", "password": "..."}'

1. La risposta contiene access (di breve durata) e refresh. Inviate il primo così: Authorization: Bearer <access>.
2. Quando access scade, ottenetene uno nuovo:

curl -X POST https://votre-nom.altiusforms.com/api/v1/token/refresh/ -H "Content-Type: application/json" -d '{"refresh": "<refresh>"}'

1. Per disconnettervi, invalidate il token refresh:

curl -X POST https://votre-nom.altiusforms.com/api/v1/token/blacklist/ -H "Content-Type: application/json" -d '{"refresh": "<refresh>"}'

Buone pratiche

• Create un account dedicato per ogni integrazione, con un ruolo limitato a ciò che le serve.
• Non inserite mai un token nel codice di una pagina web pubblica.