1. Home
  2. Gateway
  3. HTTP Api
  4. Allgemeines

Allgemeines

Setzen Sie einen Request an die URL https://gateway.sms77.io/api ab und senden Sie dabei die benötigten Variablen wahlweise per als HTTP GET oder HTTP POST Parameter. Aus Sicherheitsgründen und auch beim Versand größerer Sendungen an viele Empfänger oder bei längeren SMS Texten empfehlen wir einen Aufruf via POST.

Alternativ können Sie die Daten auch direkt als JSON im Post body übertragen. Setzen Sie hierzu den Header content-type: application/json – Sie sollten zusätzlich accept: application/json setzen, um JSON in der Antwort zu erhalten.

Bitte achten Sie darauf, dass sämtliche Parameter in eine URL-Kodierte Form übertragen werden, bevor Sie den Request senden.

Authentifizierung

Die Authentifizierung bei der HTTP Api erfolgt mittels Übergabe von Ihrem Api Key als GET/POST Parameter. Bitte verwenden Sie folgende Werte:

Parameter Wert
p Ihr Api Key – diesen finden Sie in Ihrem Login unter Entwickler > API Key

Sicherer wäre eine Authentifizierung per HTTP Basic Authentication. Senden Sie dazu den folgenden Header an unsere API:

Authorization: basic IHR_API_KEY

API Limits

Alle unsere Schnittstellen sind in Summe auf maximal 50 Verbindungen je Sekunde beschränkt. Bitte bündeln Sie Ihre Anfragen entsprechend, indem Sie z.B. mehrere SMS in einem Request senden. Sollten Sie darüber hinaus dennoch mehr Requests pro Sekunde senden wollen, nutzen Sie bitte keep-alive der Verbindung. So vermeiden Sie zusätzlich den Overhead eines Verbindungsaufbaus.

Sicherheit

Zur Absicherung Ihres Accounts haben wir folgende Sicherheitsmechanismen implementiert:

1. Api Key

Der Zugriff auf die API ist nur mit Ihrem API Key möglich. Sollte ein Dritter an diesen gelangen, kann dieser sich dennoch nicht in Ihren Account einloggen. Sie finden Ihren Api Key in Ihrem Login unter dem Punkt Entwickler im Bereich API Schlüssel. Sie können verschiedene Keys über das grüne Plus hinzufügen.

2. IP Whitelist

Zur Erhöhung der Sicherheit können Sie in Ihrem Login unter Entwickler im Bereich API Schlüssel eine oder mehrere IPs eingeben, von welchen aus über Ihren Account auf die HTTP Api zugegriffen werden darf. Sie können die Einstellungen durch einen Klick auf die blauen Zahnräder aufrufen. Auch möglich ist die Angabe eines Hostnamen, welcher dann durch die API beim Aufruf aufgelöst und geprüft wird. Mehrere Werte können kommasepariert eingegeben werden. Bitte beachten Sie, dass die Whitelist nur in Kombination mit einer statischen IP Adresse sinnvoll ist.

3. SSL Verschlüsselung

Ein Aufruf der API via http:// ist zwar möglich, jedoch empfehlen wir aus Sicherheitsgründen den verschlüselten Versand per SSL zu verwenden. Verwenden Sie hierzu die URL https://gateway.sms77.io/api/....

Fandest du diesen Artikel hilfreich? Ja 5 Nein 3
Menü