API позволяет рассылать сообщения через ваши проекты и сервисы по протоколам HTTP/HTTPS, SMTP и SMPP. Готовые библиотеки на разных языках программирования подключаются к вашему проекту и помогают отправлять сообщения из любого места с помощью одной команды.
| Получение данных о короткой ссылкеДля получения информации о короткой ссылке необходимо вызвать методом GET или POST адрес:
http://my.smsc.dp.ua/sys/tinyurls.php?get=1&login=<login>&psw=<password>&link=<link>
или
http://my.smsc.dp.ua/sys/tinyurls.php?get=1&login=<login>&psw=<password>&id=<id>
Описание параметров, передаваемых Серверу:
Параметр | Значение
|
---|
login | Логин Клиента.
|
---|
psw | Пароль Клиента (можно добавить или изменить на данной странице).
|
---|
link | Исходная полная ссылка.
|
---|
id | Идентификатор короткой ссылки. Назначается автоматически при создании.
|
---|
В случае ошибки Сервер возвращает следующую строку:
- 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 | Неверный логин или пароль.
|
---|
3 | Ссылка не найдена.
|
---|
4 | IP-адрес временно заблокирован.
|
---|
9 | Попытка отправки более трех одинаковых запросов на получение
информации о короткой ссылке в течение минуты.
Данная ошибка возникает также при попытке отправки более 15 любых запросов одновременно.
|
---|
В случае успешного запроса Сервер возвращает ответ в виде строки:
- при fmt = 0: id = <id>, cnt = <cnt>, cnt_mon = <cnt_mon>, cnt_day = <cnt_day>, cnt_yes = <cnt_yes>, cnt_pmon = <cnt_pmon>, link = <link>
- при fmt = 1: <id>,<cnt>,<cnt_mon>,<cnt_day>,<cnt_yes>,<cnt_pmon>,<link>
- при fmt = 2:
<result>
<id>id</id>
<cnt>cnt</cnt>
<cnt_mon>cnt_mon</cnt_mon>
<cnt_day>cnt_day</cnt_day>
<cnt_yes>cnt_yes</cnt_yes>
<cnt_pmon>cnt_pmon</cnt_pmon>
<link>link</link>
</result>
|
- при fmt = 3:
{
"id": "<id>",
"cnt": "<cnt>",
"cnt_mon": "<cnt_mon>",
"cnt_day": "<cnt_day>",
"cnt_yes": "<cnt_yes>",
"cnt_pmon": "<cnt_pmon>",
"link": "<link>"
} |
Где:
<id> – идентификатор короткой ссылки.
<cnt> – количество всех переходов по короткой ссылке.
<cnt_mon> – количество переходов по короткой ссылке за месяц.
<cnt_day> – количество переходов по короткой ссылке за сегодня.
<cnt_yes> – количество переходов по короткой ссылке за вчера.
<cnt_pmon> – количество переходов по короткой ссылке в предыдущем месяце.
<link> – короткая ссылка.
Пример:
Получение информации о короткой ссылке с id="145142":
http://my.smsc.dp.ua/sys/tinyurls.php?get=1&login=alex&psw=123&id=145142
Получение информации о короткой ссылке по полной исходной ссылке "mywebsite.ru":
http://my.smsc.dp.ua/sys/tinyurls.php?get=1&login=alex&psw=123&link=mywebsite.ru
Сервер не принимает более трех одинаковых запросов в течение минуты на получение информации
о короткой ссылке для снижения нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.
|
|