register

www.smska.cz

Odesílání SMS z webu, brána pro odesíání SMS z Vašich aplikací. Informujte své zákazníky a partnery on-line pomocí SMS zpráv na jejich mobilní telefon. Dále nabízíme možnost sledování stavu doručení zpráv, potvrzrení o doručení a příjmu SMS odpovědí. Všechny služby SMS brány jsou dostupné i pomocí programátorského API pro Vaše aplikace.

Registrace jsou pozastaveny.

Dokumentace k SMS API SMSKA.cz

Volání SMS API

Veškeré parametry se předávají API pomocí HTTP nebo HTTPS metodou GET (přímo v URL adrese). Název API funkce je obsažen v parametru action. Ve speciálním případě, kdy není parametr action zadán je zvolena funkce odeslat SMS. API podporuje předávání diakritiky (url encoded - v PHP urlencode()) v kódování UTF-8. Znaky s diakritikou, které není možné uložit do SMS budou nahrazeny za jejich ekvivalenty bez diakritického znaménka.

Povinné parametry všech metod

  • uid - číselné UID které používáte pro přihlášení na těchto stránkách
  • password - heslo které používáte pro přihlášení na těchto stránkách
Oba tyto parametry je možné poslat i metodou POST.

Odesílání SMS delších než 160 znaků

SMS zpráva defaultně automaticky zkrácena na 160 znaků, tak aby při odeslání příliš dlouhého řetězce nemohlo dojít k rychlému vyčerpání kreditu. Pokud ale chcete odesílat delší SMS zprávy (rozdělené do několika SMS zpráv a následně složené v mobilním telefonu příjemce) je nutné doplnit parametr max_length, který udává maximání počet SMS do kterých smí být text rozdělen.

Ukázka URL pro volání oddeslání SMS pomocí API

http://sms.hosting90.cz?uid=XXXX&password=XXXX&number=%2B420123456789&text=text+sms+zpravy
Jako parametr UID uveďte své přihlašovací jméno tak, jak Vám bylo vygenerováno touto SMS bránou po registraci. Parametr password obsahuje Vami zvolené heslo.

GET parametry pro odesílání SMS

  • text - text sms zprávy
  • number - telefonní číslo ve tvaru +420123456789
  • max_length - maximální počet sms zpráv, na který může být text rozdělen (zprávy delší než 160 znaků)
  • react_email - zaslat odpovědi na email (může být prázdný)
  • react_number - zaslat odpovědi na mobil (může být prázdný)
  • react_http - zavolat skript při odpovědi na tuto sms (může být prázdný). Skriptu budou předány následující GET proměnné:
    • number - číslo, které obdrželo odpověď
    • sender - odesílatel odpovědi
    • income_text - text odpovědi
    • source_text - původní text SMS
  • notification_http - zavolat skript při doručení této SMS (může být prázdný). Skriptu budou předány následující GET proměnné:
    • number - telefonní číslo
    • text - text SMS
    • id - id vrácené při vytvoření sms
  • delivery_notification - mail, kam zaslat notifikaci o doručení (může být prázdný)
  • custom - volitelné pole pro identifikaci zprávy, toto pole bude součástí výpisu
  • at - poslat sms v daný čas. Formát času je MySQL timestamp, tj. RRRR-MM-DD HH:MM:SS. Čas je lokální, tj. CET/CEST. Parametr je nepoviný.

Návratové hodnoty při odesílání SMS

Při odeslání SMS je vráceno xml obsahující následující atributy:
  • state - "ok" pokud se poerace zdařila, "error" pokud došlo k chybě při odesílání
  • text - tento atribut je vrácen pouze při chybě a obsahuje popis chyby.
  • msg_num - do kolika SMS byla zpráva rozdělena
  • id - id zprávy, pod kterým je uložena v archivu

Příklad na odesílání volání SMS API (PHP)

V příkladu je nutné vyplnit uid, heslo a telefon, kam chcete poslat SMS.
<?
// Funkce vytváří obecnou vrstvu pro komunikaci s SMS bránou a umožňuje volat všechny funkce API.
function rpc($string){
  $uid = ""; // UID - číslo uživatelského účtu
  $pass = ""; // heslo k uživatelskémů učtu smska.cz
  $ch = curl_init();
  curl_setopt(
    $ch,
    CURLOPT_URL,
    "http://sms.hosting90.cz/index.php?uid=${uid}&password=${pass}&${string}"
  );
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($ch, CURLOPT_TIMEOUT, 10);
  $return = curl_exec($ch);
  curl_close($ch);

  if ($return === FALSE) return false;

  try {
    $reply = @(new SimpleXMLElement($return));
  } catch (Exception $e) {
    return FALSE;
  }

  return $reply;
}

function send_sms($number, $text){
  return rpc("text=".urlencode($text)."&max_length=5&number=".urlencode($number));
}

send_sms("+420123456789", "text sms zpravy");

?>
Používejte naši bránu v programu ESMSKA!
esmska
Stáhnout ESMSKA

Nejlevnější odesílání přes naši bránu, podpora adresářů, odesílání na skupiny.

Plugin: SMSKA.cz
 

Provozní podmínky | Webhosting | Virtuální servery (VPS) | Parkování domény | Domény

Copyright (c) 2009-2011 HOSTING90 systems s.r.o., Všechna práva vyhrazena