Toto API slouží k získání informací o SMS.
Základní popis a tvar API volání a odpovědi najdete popsané samostatně .
Služba
SMS info API patří do služby SMS (sms ).
Parametry volání API
Volání musí obsahovat všechny základní parametry .
CTRL
Pevná hodnota: sms_info
id
Identifikátor SMS získaný při odesílání SMS, vizte odpověď na API pro odeslání SMS .
Příklady volání API
ukázka 1: Získání informace o SMS (implementace v PHP)
$login = 'user';
$call = microtime(true);
$password = md5(md5("heslo").$call);
$url = "https://api.profisms.cz/index.php?" . http_build_query(array(
"CTRL" => "sms_info",
"_login" => $login,
"_password" => $password,
"_service" => "sms",
"_call" => $call,
"id" => 146,
));
/**
URL bude vypadat
https://api.profisms.cz/index.php?CTRL=sms&_login=user
&_password=5ec91cfbcbdcdf55748400c8006debd1&_service=sms
&_call=b338a71d833a9c8c4349d392d7ae1e2fb7bcb3ad4d1a519a989716.38230669
&id=146
*/
$json = join("", file($url));
Odpověď na úspěšný požadavek na API
Základní formát odpovědi naleznete v obecném popisu API .
Popis objektu data
Objekt data obsahuje tyto vlastnosti:
id
Unikátní identifikátor SMS (nejedná o sekvenční číslo, nereprezentuje pořadí v systému ProfiSMS).
V současné době má vlastnost formát čísla, ale jedná se o řetězec, v budoucnosti se může tato vlastnost změnit na čistý řetězec.
Tento identifikátor se používá při předávání doručenek a pro dotazovaní na stav SMS.
state
Stav SMS .
delivery
Stav doručení SMS .
type
Typ SMS .
msisdn
Telefonní číslo příjemce (zformátované do mezinárodního tvaru).
name
Název SMS (v případě wappushe)
text
Text SMS.
validity
Počet minut, po které je SMS platná.
queued
Datum zařazení SMS do fronty ve formátu rrrr-mm-dd hh:nn:ss.
delivered
Datum doručení SMS (nastavení stavu SMS, tzn. i datum nedoručení SMS, apod.) ve formátu rrrr-mm-dd hh:nn:ss.
part
Pole částí SMS (vizte níže).
partsCount
Počet částí SMS, na které byla SMS rozdělena.
address
Adresa pro doručenku (na základě parametrů delivery nebo address při požadavku na odeslání).
source
Číslo nebo textový identifikátor odesilatele.
account
Unikátní číslo účtu (variabilní symbol pro běžné platby) ze kterého proběhla platba.
Popis objektů v poli part
Objekt v poli part obsahuje tyto vlastnosti:
id
Unikátní identifikátor části SMS (nejedná o sekvenční číslo, nereprezentuje pořadí v systému ProfiSMS).
V současné době má vlastnost formát čísla, ale jedná se o řetězec, v budoucnosti se může tato vlastnost změnit na čistý řetězec.
Tento identifikátor se používá při předávání doručenek.
state
Stav části SMS .
delivery
Stav doručení části SMS .
queued
Datum zařazení části SMS do fronty ve formátu rrrr-mm-dd hh:nn:ss.
delivered
Datum doručení části SMS (nastavení stavu části SMS, tzn. i datum nedoručení části SMS, apod.) ve formátu rrrr-mm-dd hh:nn:ss.
Ukázky požadavků a odpovědí
ukázka 2: Požadavek (implementace v PHP)
$login = 'user';
$call = microtime(true);
$password = md5(md5("heslo").$call);
$url = "https://api.profisms.cz/index.php?" . http_build_query(array(
"CTRL" => "sms_info",
"_login" => $login,
"_password" => $password,
"_service" => "sms",
"_call" => $call,
"id" => '1544185',
));
ukázka 3: SMS odeslaná a doručená
{
"error":
{
"code":0,
"message":"OK"
},
"data":
{
"id":"1544185",
"state":"sent",
"delivery":"delivered",
"type":"text",
"msisdn":"+420605582922",
"name": "",
"text": "p\u0159\u00edli\u0161 \u017elu\u0165ou\u010dk\u00fd k\u016f\u0148 \u00fap\u011bl \u010f\u00e1belsk\u00e9 ody, p\u0159\u00edli\u0161 \u017elu\u0165ou\u010dk\u00fd k\u016f\u0148 \u00fap\u011bl \u010f\u00e1belsk\u00e9 ody",
"validity":5,
"queued":"2010-12-28 17:54:05",
"delivered":"2010-12-28 17:55:00",
"part":
[
{
"id":"44109244",
"state":"sent",
"delivery":"delivered",
"queued":"2010-12-28 17:54:05",
"delivered":"2010-12-28 17:55:00"
},
{
"id":"44109245",
"state":"sent",
"delivery":"delivered",
"queued":"2010-12-28 17:54:05",
"delivered":"2010-12-28 17:55:00"
}
],
"address": "http:\/\/tmp.company.cz\/tmp.php",
"partsCount": 2,
"source":"ztestu",
"account":"123456"
},
"_key":"ab2063832062b63434a93f091e16df2b",
"_time":0.229101896286
}
Podobně jako v případě odeslání
spožděné SMS pomocí API , pokud SMS ještě nebyla odeslána,
pole part bude prázdné.
ukázka 4: Odpověď pro zpožděnou SMS
{
"error":
{
"code":0,
"message":"OK"
},
"data":
{
"id":"1561947",
"state":"inserted",
"delivery":"nostate",
"type":"text",
"msisdn":"+420605582922",
"name": "",
"text": "p\u0159\u00edli\u0161 \u017elu\u0165ou\u010dk\u00fd k\u016f\u0148 \u00fap\u011bl \u010f\u00e1belsk\u00e9 ody, p\u0159\u00edli\u0161 \u017elu\u0165ou\u010dk\u00fd k\u016f\u0148 \u00fap\u011bl \u010f\u00e1belsk\u00e9 ody",
"validity":5,
"queued":"",
"delivered":"",
"part":[],
"address": "http:\/\/tmp.company.cz\/tmp.php",
"partsCount": 2,
"source":"ztestu",
"account":""
},
"_key":"5f848e3b6876d1df0800ad6dced92633",
"_time":0.0822818279266
}
Odpověď na neúspěšný požadavek na API
Chyba ID
Uživatel se smí dotazovat pouze na SMS, které sám odeslal. V případě dotazu na SMS, která mu nepatří, nebo která neexistuje, je vrácen objekt,
který syntaxí odpovídá odpovědi na správný požadavek, pouze je tento objekt prázdný (vlastnost id je nulová).
ukázka 5: Odpověď na chybný identifikátor
{
"error":
{
"code":0,
"message":"OK"
},
"data":
{
"msisdn":"",
"id":0,
"state":"queued",
"delivery":"nostate",
"queued":"",
"delivered":"",
"part":[],
"address": "",
"partsCount": 0
},
"_key":"6248cfb5d0c42b8da78b062b0dae9053",
"_time":0.0802619457245
}
Chyba požadavku
Základní formát odpovědi naleznete v obecném popisu API .
Použití API pro vytvoření aplikace komunikující s ProfiSMS je podmíněno souhlasem s podmínkami pro použití služby ProfiSMS.
Verze: 1.000 | 2010-12-29 | support@profisms.cz