Um SMS auf lima-city nutzen zu können, benötigst du ein passendes Kontingent dazu. Kontingente kaufen kannst du über das Menü "Verwaltung > Kontingente > SMS zum Warenkorb hinzufügen" (https://www.lima-city.de/usercp/contingents). Die Preisliste und weitere Informationen dazu findest du unter "Kontingente" in der Hilfe.
Mit der SMS-API kannst du von deinen PHP-Skripten aus SMS versenden. Dabei wird dein Kontingent belastet. Um eine SMS zu versenden musst du lediglich das Skript unter http://api.lima-city.de/sms aufrufen.
Für Auslands-SMS werden 2 SMS vom Kontingent abgebucht, da diese teurer sind. Für Inlands-SMS (Deutschland) wird 1 SMS vom Kontingent abgebucht.
Eine SMS kann bis zu 160 Zeichen umfassen. Manche Sonderzeichen belegen 2 Stellen.
Dabei sind folgende Parameter zu beachten:
Parameter Erklärung
number: Die Nummer, an die gesendet wird. Formatbeispiele: 004916012345678 (Landesvorwahl 0049 für Deutschland, Netz 0160 ohne führende 0, Nummer 12345678), Beispiel für Österreich: 004317212345678 (Landesvorwahl 0043, Netz 0172 ohne führende 0, Nummer 12345678)
text: Der Text, den du senden möchtest
user_id: Deine User-ID
apikey: Ein Schlüssel aus zufälligen Zeichen, der sicherstellt, dass niemand über dein Kontingent SMS versendet.
Die Ländervorwahl ist notwendig, auch bei deutschen Anbietern!
Ein solcher Aufruf kann beispielsweise so aussehen:
<?php
$message_text = 'Hallo Empfänger!'; // Nachricht
$mobile_number = '004917612345678'; // Handy-Nummer des Empfängers
$user_id = '12345'; // Deine persönliche User-ID
$secret_apikey = 'abcdefghijklmno'; // Dein geheimer API-Schlüssel
$param_text = urlencode(utf8_decode($message_text));
$retval = file_get_contents('https://api.lima-city.de/sms?user_id=' . $user_id . '&apikey=' . $secret_apikey . '&text=' . $param_text . '&number=' . $mobile_number);
if ($retval == 100) {
echo "SMS wurde gesendet!";
} else {
echo "SMS wurde nicht gesendet!";
}
?>
Umlaute und Sonderzeichen müssen im korrekten Encoding gesendet werden: ISO-8859-1 (nicht UTF-8!). Bei Problemen wird ein Fehlercode zurückgegeben. Grundlage der Zeichencodierung ist allgmeiner GSM-Standard mit 160 Zeichen (Sonderzeichen belegen 2 Stellen): http://de.wikipedia.org/wiki/SMS-Kodierung
Rückgabewerte:
Nur im OK-Fall werden von deinem Kontingent SMS abgebucht.
Der Versand von SMS erfolgt über das PHP-Skript mit Hilfe der SMS-API, wie oben beschrieben.
lima-city speichert keine Daten, die über die SMS-API übertragen werden. Wir schicken dir auch keine Handy-Werbung zu und geben deine Daten nicht weiter. Die übermittelten Daten werden auschließlich verwendet, um die gewünschte SMS zu versenden.