Allgemeines zum SMS-Kontingent

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.

SMS-API

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:

  • 100: Alles in Ordnung; SMS wurde an das Versandsystem übergeben und dürfte gleich beim Empfänger eintreffen.
  • 200: Fehler; Da lief irgendetwas schief. Überprüfe die Parameter und den Text. Wenn dies öfters auftritt, kontaktiere uns bitte per Support-Ticket.
  • 300: Fehler; Kein SMS-Kontingent, falsche User-ID oder falscher API-Key.
  • 301: Fehler; Die Handynummer hat ein ungültiges Format

Nur im OK-Fall werden von deinem Kontingent SMS abgebucht.

SMS-Versand

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.