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.

Beispiel Request mit HTTP Basic Auth

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 authorisiert hat.

Erfahren Sie mehr zu OAuth2.0 →

Beispiel Request mit Bearer Auth

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

Beispiel Request mit x-api-key header

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

Veraltet

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.

Details anzeigen

Name
u
Type
string
Optional
Optional
Description
Ihr Loginalias oder Ihre Mailadresse. Muss angegeben werden, wenn p das Loginpasswort enthält.
Name
p
Type
string
Description
Ihr API-Schlüssel oder Ihr Loginpasswort.

Beispiele

HTTP GET mit Benutzer/Passwort

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

HTTP GET mit API Schlüssel

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

HTTP POST mit API Schlüssel

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