| Получение статистикиДля получения статистики отправленных сообщений необходимо вызвать методом GET или POST адрес:
http://my.smsc.dp.ua/sys/get.php?get_stat=1&login=<login>&psw=<password>&start=<date1>&end=<date2>
Описание параметров, передаваемых Серверу:
Параметр | Значение
|
---|
login | Логин Клиента.
|
---|
psw | Пароль Клиента (можно добавить или изменить на данной странице).
|
---|
start | Начальная дата в периоде, за который запрашивается статистика. Формат: 'дд.мм.гггг'.
|
---|
end | Конечная дата в периоде. Если не указана, то возвращаются данные с начальной даты. Формат: 'дд.мм.гггг'.
|
---|
mycur | Флаг, позволяющий выводить статистику в текущей валюте Клиента.
|
---|
balance2 | Флаг, позволяющий получить статистику по отправленным сообщениям, оплаченным с электронного баланса.
|
---|
В случае ошибки Сервер возвращает следующую строку:
- ERROR = N (описание)
- При fmt = 1:
0,-N
- При fmt = 2:
<result>
<error>описание</error>
<error_code>N</error_code>
</result> |
- При fmt = 3:
{
"error": "описание",
"error_code": N
} |
N – номер ошибки, может принимать следующие значения:
Значение | Описание
|
---|
1 | Ошибка в параметрах.
|
---|
2 | Неверный логин или пароль. Также возникает при попытке отправки сообщения с IP-адреса, не входящего в список разрешенных Клиентом (если такой список был настроен Клиентом ранее).
|
---|
4 | IP-адрес временно заблокирован.
|
---|
9 | Попытка отправки более трех одинаковых запросов на получение списка входящих сообщений в течение минуты.
Данная ошибка возникает также при попытке отправки пятнадцати и более запросов одновременно с разных подключений под одним логином (too many concurrent requests).
|
---|
В случае успешного запроса Сервер возвращает ответ в виде строки:
- при fmt = 0:
login = <login>, sms = <cnt>, credit = <credit>, debit = <debit>, currency = <currency>
... |
- при fmt = 1:
<login>,<cnt>,<credit>,<debit>,<currency>
... |
- при fmt = 2:
<list>
<stat>
<login>login</login>
<sms>cnt</sms>
<credit>credit</credit>
<debit>debit</debit>
<currency>currency</currency>
</stat>
...
</list> |
- при fmt = 3:
[{
"login": "<login>",
"sms": "<cnt>",
"credit": "<credit>",
"debit": "<debit>",
"currency": "<currency>"
},
...] |
Где:
<login> - логин Клиента.
<cnt> - количество сообщений.
<credit> - расход.
<debit> - приход.
<currency> - трехсимвольный код валюты.
Примеры:
Получение статистики в текущей валюте Клиента с "01.01.2014" по "01.02.2014" по безналичному балансу:
http://my.smsc.dp.ua/sys/get.php?get_stat=1&login=alex&psw=123&mycur=1&start=01.01.2014&end=01.02.2014
Сервер не принимает более трех запросов в течение минуты на получение статистики для снижения
нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.
|