Authentifizierung

Zur Authentifizierung an unserer API benötigen Sie einen API-Schlüssel. Diesen können Sie in Ihrem Login im Bereich Entwickler erstellen und einsehen. Mehr dazu erfahren Sie in unserem Hilfeartikel.

API-Schlüssel jetzt erstellen

HTTP Basic Auth

Verwenden Sie HTTP Basic Auth mit Ihrem API-Schlüssel. Der API-Schlüssel wird direkt als Header gesendet, eine weitere Kodierung per Base64 ist nicht erforderlich.

curl https://gateway.seven.io/api/sms \
  -H 'Authorization: basic IHR_API_SCHLÜSSEL'

OAuth2 mit Bearer Token

Voraussetzung zur Authentifizierung ist, dass eine App bei uns registriert ist und der Kunde diese zur Nutzung der API autorisiert hat.

Erfahren Sie mehr zu OAuth2.0 →

curl https://gateway.seven.io/api/sms \
  -H 'Authorization: Bearer ACCESS_TOKEN'

Authentifizierung per HTTP Header

Senden Sie Ihren API Request mit Ihrem API-Schlüssel im X-Api-Key Header

curl https://gateway.seven.io/api/sms \
  -H 'X-Api-Key: IHR_API_SCHLÜSSEL'

Authentifizierung per GET/POST Parameter bzw. Benutzer/Passwort

Alternativ zu oben genannten Methoden unterstützen wir weiterhin die Authentifizierung per API-Schlüssel als GET oder POST Parameter p.

Speziell die Übertragung per GET gilt als nicht sicher und sollte daher nicht verwendet werden. Aus Kompatibilitätsgründen ist auch weiterhin die veraltete Authentifizierung per Benutzer/Passwort möglich. Hiervon wird dringend abgeraten.

curl "https://gateway.seven.io/api/endpunkt?u=IHR_LOGIN&p=IHR_PASSWORT"

curl "https://gateway.seven.io/api/endpunkt?p=IHR_API_SCHLÜSSEL"

curl -X POST "https://gateway.seven.io/api/endpunkt" \
  -d "p=IHR_API_SCHLÜSSEL"