Authentifizierung
Jede Anfrage braucht ein API-Token. Du erhältst Tokens, sobald E-Mail und Handynummer bestätigt sind (unter API & Konto). Du kannst bis zu 5 Tokens anlegen – am besten je Anwendung eines – und sie jederzeit widerrufen. Optional beschränkst du ein Token mit einer IP-Whitelist (einzelne IPs oder CIDR-Bereiche) auf bestimmte Server.
| Variante | Wie | Wann |
|---|---|---|
| Header (empfohlen) | Authorization: Bearer TOKEN oder X-API-Token: TOKEN | Überall, wo du Header setzen kannst. |
| URL-Parameter | ?token=TOKEN | Nur für einfache Systeme ohne Header-Unterstützung (Router, Monitoring). Der Token steht dann in Server-Logs. |
Das Token wird nur einmal bei der Erstellung angezeigt und bei uns nur als Hash gespeichert. Ist es verloren, lege ein neues an und widerrufe das alte.