Authentification

Authentification

L'API accepte deux méthodes. Le jeton API personnel convient aux scripts et aux intégrations ; le JWT convient aux applications où une personne se connecte avec son e-mail et son mot de passe.

Jeton API personnel

1. Ouvrez API et intégration.
2. Cliquez sur Générer un jeton API.
3. Copiez le jeton et envoyez-le dans l'en-tête Authorization de chaque requête :

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

Le jeton agit en votre nom, avec vos droits : gardez-le secret. Renouveler le jeton en crée un nouveau et invalide aussitôt l'ancien ; Révoquer le jeton le supprime. Dans les deux cas, les intégrations qui utilisaient l'ancien jeton cessent de fonctionner jusqu'à leur mise à jour.

JWT : e-mail et mot de passe

1. Demandez une paire de jetons :

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

1. La réponse contient access (courte durée) et refresh. Envoyez le premier ainsi : Authorization: Bearer <access>.
2. Quand access expire, obtenez-en un nouveau :

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

1. Pour vous déconnecter, invalidez le jeton refresh :

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

Bonnes pratiques

• Créez un compte dédié pour chaque intégration, avec un rôle limité à ce dont elle a besoin.
• Ne mettez jamais un jeton dans le code d'une page web publique.