Berechtigungs- und Zugangsbereiche
Anmeldung per Link
Ihr Server ruft POST /v1/auth/login-link mit X-API-Key und X-Customer-ID auf. Mit mailbox_id wird nur dieses Postfach geöffnet; ohne das Feld das gesamte Konto. locale legt die Sprache der Oberfläche fest.
Die Antwort enthält login_url, expires_in=300, expires_at (UTC), account_id und mailbox_id. Die Schaltfläche „Postfach öffnen“ öffnet die vollständige login_url einschließlich #token. Der Link gilt 5 Minuten und nur einmal. Protokollieren Sie ihn nicht und geben Sie den API-Schlüssel nicht im Browser preis.
Die Anmeldeseite entfernt den Token aus der Adressleiste und tauscht ihn gegen HttpOnly-Cookies ein. Bei Fehlern oder Ablauf erstellen Sie einen neuen Link. Berechtigungen sowie Konto- und Postfachstatus werden erneut geprüft. Benutzersitzungen können keine Links erstellen.
curl https://adapt-mail.com/v1/auth/login-link \ -H "X-API-Key: <mail-api-key>" \ -H "X-Customer-ID: <mail-account-id>" \ -H "Content-Type: application/json" \ --data '{"mailbox_id":42,"locale":"en"}'
{ "login_url": "https://adapt-mail.com/auth/#token=<one-time-token>", "expires_in": 300, "expires_at": "2026-10-20T12:05:00Z", "account_id": 123, "mailbox_id": 42}Partnerschlüssel
Verwenden Sie den E-Mail-Schlüssel API- Ihrer Integration. Übergeben Sie es an X-API-Key und ID des E-Mail-Kontos – im erforderlichen Header X-Customer-ID. Dies ist ID des Kontos, nicht external_id und nicht ID des Postfachs. Der Schlüssel ermöglicht den Zugriff nur für Clients Ihrer Integration.
Speichern Sie den Schlüssel auf dem Server Ihres Partners. Platzieren Sie den gemeinsamen Integrationsschlüssel nicht im Browser oder in der mobilen Anwendung.
curl 'https://adapt-mail.com/v1/mailboxes' \ -H 'X-API-Key: <mail-api-key>' \ -H 'X-Customer-ID: <mail-account-id>'Benutzertoken
POST /v1/auth/token akzeptiert login, password und mode. Für mode=account wird der Login user-ID verwendet, für mode=mailbox wird die vollständige Postfachadresse verwendet. Konto- und Postfachkennwörter sind unabhängig.
Die Antwort enthält access_token, token_type=Bearer und expires_in=3600.. Das Konto-Token öffnet seine Boxen; Box-Token – nur eine Box. Nach Ablauf erhalten Sie einen neuen Token.
POST /v1/auth/tokenContent-Type: application/json
{"login":"user-123","password":"<password>","mode":"account"}
GET /v1/mailboxesAuthorization: Bearer <access_token>Browsersitzungen
POST /v1/auth/login ist für seine eigene Site adapt-mail.com. Es erfordert das richtige Origin und installiert HttpOnly cookies. Nicht klassifiziert X-Mail-Session wählt eine der gespeicherten Eingaben aus, aber ohne cookie gewährt es keinen Zugriff.
Für Drittanbieter-Frontends verwenden Sie Ihren Server und Ihr Benutzertoken. Rechnen Sie nicht mit dem zufälligen domänenübergreifenden Zugriff von cookie: public CORS für irgendeine Site-Nr.