Entwickler HTTP SMS API v.2 zur Kommunikation mit dem SMS Gateway
Dieses Dokument gibt einen Überblick auf alle verfügbaren Funktionen der HTTP-Schnittstelle zum Versenden von SMS.
Die HTTP API kann Ihre Anwendung (Client) mit SMSCenter.gr (Gateway), unter Zuhilfenahme des HTTP Protocols zum Versenden von SMS, integrieren.
Allgemeine Informationen
Der Client schickt eine HTTP GET Anfrage mit einer Liste aller benötigten Parametern zur SMSCenter.gr HTTP-Schnittstelle. SMSCenter.gr sendet eine HTTP Antwort zurück, die eine erfolgreiche Transaktion bedeutet.
Beachten Sie, dass in den unten aufgeführten Fällen das benutzte Trennzeichen für Rückgabewerte status API call '|', der senkrechte Strich (ASCII 124) ist.
Alle übergebenen Parameter müssen URL-kodiert und in UTF-8 sein, wie in den folgenden Code Beispielen beschrieben.
API Antworten-Format
Die API antwortet allen Clients gemäß dem type Parameter. Akzeptierte Werte für den type Parameter sind: v2 was der Standardwert ist, json und xml.
Beispielantwort für den API Aufruf key/get:
URL: https://static.smscenter.gr/api/key/get?username=[username]&password=[password]&type=...
...&type=v2
Antwortet:
6fe2dd9c06df83
...&type=json
Antwortet:
{
"status" : "1",
"key" : "6fe2dd9c06df83",
"remarks" : "Success"
}
...&type=xml
Antwortet:
<response>
<status>1</status>
<key>6fe2dd9c06ff83</key>
<remarks>Success</remarks>
</response>
Testen Sie es (key/get)
https://static.smscenter.gr/api/key/get?username=&password=&type=
Alle verfügbaren Befehle für der SMSCenter.gr API v.2 Version sind hier aufgelistet.
API Key
Der API Key sollte anstatt des Benutzernamen oder Passworts für alle API Aufrufe benutzt werden. Sie können zwar Benutzernamen oder Passwort Parameter verwenden, aber wir empfehlen den API Key aufgrund Sicherheitsbedenken zu nutzen.
Sie erhalten den API Key mit dem key/get Aufruf und Sie sollten diesen für alle API Anfragen anstelle von Benutzernamen oder Passwort Parameter verwenden. Falls Sie den API Key ändern müssen, können Sie dies mit dem key/reset Aufruf tun.
Die key/get und key/reset Aufrufe sind die einzigen, die Benutzernamen und Passwort benötigen.
Wenn Sie den API Key haben, dann können Sie diesen für alle API Aufrufe benutzen.
Testen Sie es (key/get)
https://static.smscenter.gr/api/key/get?username=&password=&type=
Testen Sie es (key/reset)
https://static.smscenter.gr/api/key/reset?username=&password=&type=
Ergebnis
...&type=v2
Antwortet:
6fe2dd9c06df83
...&type=json
Antwortet:
{
"status" : "1",
"key" : "6fe2dd9c06df83",
"remarks" : "Success"
}
...&type=xml
Antwortet:
<response>
<status>1</status>
<key>6fe2dd9c06ff83</key>
<remarks>Success</remarks>
</response>
SMS verschicken
URL: https://static.smscenter.gr/api/sms/send?key=[API Key]
Akzeptierte Parameter
| Parameter | Beschreibung | Notwendigkeit |
|---|---|---|
text |
Die zu sendende Nachricht. Muss URL-kodiert sein. | Pflicht |
to |
MSIDSN des Empfängers der Nachricht. z. B.: 49175123456 | Pflicht |
from |
Absender (alphanumerisch: max. 11 Zeichen, numerisch max. 16 Ziffern) | Optional |
flash |
Für Flash SMS auf TRUE setzen | Optional |
ucs |
Für UCS-encoding auf TRUE setzen | Optional |
timestamp |
Unix Epoch Zeitstempel setzen | Optional |
type |
Der Typ der API Antwort kann entweder v2, json oder xml sein. |
Optional |
Rückgabe (Returns)
...&type=v2
Antwortet:
1234567890
...&type=json
Antwortet:
{
"status" : "1",
"id" : "1234567890",
"balance" : "1234",
"remarks" : "Success"
}
...&type=xml
Antwortet:
<response>
<status>1</status>
<id>1234567890</id>
<balance>1234</balance>
<remarks>Success</remarks>
</response>
| Beschreibung | |
|---|---|
status |
1 für Nachricht verschickt, ansonsten fehlgeschlagen |
id |
die Nachricht ID (oder 0, wenn fehlgeschlagen), Übertragungsberichte sind an die ID gebunden |
balance |
der Kontostand |
Anmerkungen |
Anmerkungen zum Aufruf |
Testen Sie es (sms/send)
https://static.smscenter.gr/api/sms/send?key=&to=&from=&text=Hello&type=