Authentifizierung

Authentifizierung

Die API kennt zwei Verfahren. Das persönliche API-Token eignet sich für Skripte und Integrationen, das JWT für Anwendungen, bei denen sich eine Person mit E-Mail und Passwort anmeldet.

Persönliches API-Token

1. Öffnen Sie API & Integration.
2. Klicken Sie auf API-Token generieren.
3. Kopieren Sie das Token und senden Sie es im Header Authorization jeder Anfrage:

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

Das Token handelt in Ihrem Namen und mit Ihren Rechten: Halten Sie es geheim. Token rotieren erzeugt ein neues und macht das alte sofort ungültig; Token widerrufen löscht es. In beiden Fällen funktionieren Integrationen mit dem alten Token erst nach einer Anpassung wieder.

JWT: E-Mail und Passwort

1. Fordern Sie ein Token-Paar an:

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

1. Die Antwort enthält access (kurzlebig) und refresh. Senden Sie das erste als Authorization: Bearer <access>.
2. Wenn access abläuft, holen Sie ein neues:

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

1. Zum Abmelden machen Sie das refresh-Token ungültig:

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

Empfehlungen

• Legen Sie für jede Integration ein eigenes Konto an, mit einer Rolle, die nur das Nötige erlaubt.
• Setzen Sie nie ein Token in den Code einer öffentlichen Webseite.