docs

API Info, ke stažení, HASH

Váš API klíč ke vzdálenému volání.
LOGINTOGETAHASH

Ke stažení PHP třída

2022-06-01 - PHP class - smsZasilamRest (.zip)
Novinky: Nový parametr u funkce add() - možnost pozdržet odeslání SMS na daný datum a čas. Parametr má formát YYYY-MM-DD HH:MM:SS. Lze použít php relativní funkce. Např. +5 hours atp.

2021-05-20
Novinky: sablony()

2021-05-09
Novinky: Nová URL pro API

Příklady použití

PHP třída

Odeslání jedné SMS

$sms = new smsZasilamRest('LOGINTOGETAHASH');
$sms->add('+420123456789','Příliš žluťoučký kůň byl příliš žlutý.');

if (!$sms->send())
{
	echo $sms->getError();
}
else
{
	echo 'sent';
}

Odeslání více SMS

Nedoporučujeme posílat přes API více než 100 zpráv na jedno volání.

$sms = new smsZasilamRest('LOGINTOGETAHASH');

$sms->add('+420123456789','Příliš žluťoučký kůň byl příliš žlutý.');
$sms->add('+420123456789','Příliš žluťoučký kůň byl příliš žlutý.');
$sms->add('+420123456789','Příliš žluťoučký kůň byl příliš žlutý.');
$sms->add('+420123456789','Příliš žluťoučký kůň byl příliš žlutý.');
$sms->add('+420123456789','Příliš žluťoučký kůň byl příliš žlutý.');
$sms->add('+420123456789','Příliš žluťoučký kůň byl příliš žlutý.','2023-06-01 20:00:00');
$sms->add('+420123456789','Příliš žluťoučký kůň byl příliš žlutý.','+5 hours');
$sms->add('+420123456789','Příliš žluťoučký kůň byl příliš žlutý.','+24 hours');

if (!$sms->send())
{
	echo $sms->getError();
}
else
{
	echo 'sent';
}

Přijaté SMS

$sms = new smsZasilamRest('LOGINTOGETAHASH');
$sms->get();
$zpravy = $sms->send();

if(!$zpravy)
{
	echo $sms->getError();
}
elseif (is_array($zpravy) && !empty($zpravy))
{
	print_r($zpravy);
}
else
{
	echo 'no messages';
}

Odeslané SMS

$sms = new smsZasilamRest('LOGINTOGETAHASH');
$sms->getSent();
$zpravy = $sms->send();

if(!$zpravy)
{
	echo $sms->getError();
}
elseif (is_array($zpravy) && !empty($zpravy))
{
	print_r($zpravy);
}
else
{
	echo 'no messages';
}

Fronta odesílaných SMS

$sms = new smsZasilamRest('LOGINTOGETAHASH');
$sms->queue();
$zpravy = $sms->send();

if(!$zpravy)
{
	echo $sms->getError();
}
elseif (is_array($zpravy) && !empty($zpravy))
{
	print_r($zpravy);
}
else
{
	echo 'no messages';
}

Šablony zpráv

$sms = new smsZasilamRest('LOGINTOGETAHASH');
$sms->sablony();
$zpravy = $sms->send();

if(!$zpravy)
{
	echo $sms->getError();
}
elseif (is_array($zpravy) && !empty($zpravy))
{
	print_r($zpravy);
}
else
{
	echo 'no templates';
}

Konverzace SMS zpráv k danému číslu

$sms = new smsZasilamRest('LOGINTOGETAHASH');
$sms->conversation('+420123456789');
$zpravy = $sms->send();

if(!$zpravy)
{
	echo $sms->getError();
}
elseif (is_array($zpravy) && !empty($zpravy))
{
	print_r($zpravy);
}
else
{
	echo 'no messages';
}

Smazání všech SMS, které ve frontě čekají na odeslání

$sms = new smsZasilamRest('LOGINTOGETAHASH');
$sms->queuePurge();
$zpravy = $sms->send();

if(!$zpravy)
{
	echo $sms->getError();
}
elseif (is_array($zpravy) && !empty($zpravy))
{
	print_r($zpravy);
}
else
{
	echo 'error';
}

Javascript - XHR

Odeslání jedné SMS

var data = JSON.stringify([{"number":"+420123456789","text":"Příliš žluťoučký kůň byl příliš žlutý."}]);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://app.smszasilam.cz/rest/?HASH=LOGINTOGETAHASH");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.send(data);

Odeslání více SMS

Nedoporučujeme posílat přes API více než 100 zpráv na jedno volání.

var data = JSON.stringify([{"number":"+420123456789","text":"Příliš žluťoučký kůň byl příliš žlutý."},{"number":"+420123456789","text":"Příliš žluťoučký kůň byl příliš žlutý."},{"number":"+420123456789","text":"Příliš žluťoučký kůň byl příliš žlutý."}]);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://app.smszasilam.cz/rest/?HASH=LOGINTOGETAHASH");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.send(data);

Přijaté SMS

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://app.smszasilam.cz/rest/get/?HASH=LOGINTOGETAHASH");

xhr.send();

Odeslané SMS

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://app.smszasilam.cz/rest/sent/?HASH=LOGINTOGETAHASH");

xhr.send();

Šablony zpráv

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://app.smszasilam.cz/rest/sablony/?HASH=LOGINTOGETAHASH");

xhr.send();

Fronta odesílaných SMS

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://app.smszasilam.cz/rest/queue/?HASH=LOGINTOGETAHASH");

xhr.send();

Konverzace SMS zpráv k danému číslu

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://app.smszasilam.cz/rest/conversation/?HASH=LOGINTOGETAHASH&phone=+420123456789");

xhr.send();

Smazání všech SMS, které ve frontě čekají na odeslání

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://app.smszasilam.cz/rest/queue-purge/?HASH=LOGINTOGETAHASH");

xhr.send();

Potřebujete poradit?

Napište na email sms@zasilam.cz