| Статусы сообщенийПроверка статуса
Для проверки статуса доставки SMS или e-mail необходимо вызвать методом GET или POST адрес:
https://smsc.kz/sys/status.php?login=<login>&psw=<password>&phone=<phone>&id=<sms_id>
Серверу передаются следующие параметры:
Параметр | Значение
|
---|
login | Логин Клиента.
|
---|
psw | Пароль Клиента (можно добавить или изменить на данной странице).
|
---|
apikey | Специальный API-ключ, используемый для упрощенной авторизации вместо пары "логин+пароль" (можно создать на данной странице).
|
---|
phone | Номер телефона или список номеров через запятую при запросе
статусов нескольких SMS. При множественном запросе номера в списке должны
быть перечислены в порядке, соответствующем идентификаторам сообщений. Для
сохранения формата множественного запроса при запросе статуса одного сообщения
укажите запятую после номера телефона. Это описание подходит и для e-mail-сообщений.
|
---|
id | Идентификатор сообщения или список идентификаторов через запятую при
запросе статусов нескольких сообщений. Для сохранения формата множественного запроса
при запросе статуса одного сообщения укажите запятую после идентификатора
сообщения.
|
---|
fmt | Формат ответа сервера:
0 – (по умолчанию) в виде строки (Status = 1, check_time = 10.10.2010 10:10:10).
1 – в виде номера статуса и штампа времени через запятую (1,1286524541).
2 – в xml формате.
3 – в json формате.
|
---|
all | 0 – (по умолчанию) получить статус сообщения в обычном формате.
1 – получить полную информацию об отправленном сообщении.
2 – добавить в информацию о сообщении данные о стране, операторе и регионе абонента.
|
---|
charset | Кодировка результата запроса, если используется отличная от кодировки
по умолчанию windows-1251. Варианты: utf-8 и koi8-r.
|
---|
del | 1 – удалить ранее отправленное сообщение. Используется совместно с параметрами
phone и id. Более подробно данный параметр описан здесь.
|
---|
Статусы сообщений. Ответ сервера и коды ошибокВ случае ошибки Сервер возвращает следующую строку:
- При fmt = 0:
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-адрес временно заблокирован.
|
---|
5 | Ошибка удаления сообщения.
|
---|
9 | Попытка отправки более пяти запросов на получение статуса одного и того же сообщения или более одного массового запроса в течение минуты.
Данная ошибка возникает также при попытке отправки пяти и более запросов одновременно с разных подключений под одним логином (too many concurrent requests).
|
---|
В случае успешного запроса Сервер возвращает ответ в виде строки:
Ответы для SMS-сообщений:
- при fmt = 0 и all = 0: Status = <status>, check_time = <last_date>, err = <err>
- при fmt = 1 и all = 0: <status>,<last_timestamp>,<err>
- при fmt = 2 и all = 0:
<sms>
<status>status</status>
<last_date>last_date</last_date>
<last_timestamp>last_timestamp</last_timestamp>
<flag>flag</flag>
<err>err</err>
</sms> |
- при fmt = 3 и all = 0:
{
"status": <status>,
"last_date": "<last_date>",
"last_timestamp": <last_timestamp>,
"flag": <flag>,
"err": <err>
} |
- при fmt = 0 и all = 1:
Status = <status>, check_time = <last_date>, err = <err>, send_date = <send_date>, phone = <phone>, cost = <cost>, sender_id = <sender>, status_name = <status_name>, message = <message>, comment = <comment>, type = <type>
|
- при fmt = 1 и all = 1:
<status>,<last_timestamp>,<err>,<send_timestamp>,<phone>,<cost>,<sender>,<status_name>,<message>, <comment>, <type>
- при fmt = 2 и all = 1:
<sms>
<status>status</status>
<last_date>last_date</last_date>
<last_timestamp>last_timestamp</last_timestamp>
<flag>flag</flag>
<err>err</err>
<send_date>send_date</send_date>
<send_timestamp>send_timestamp</send_timestamp>
<phone>phone</phone>
<cost>cost</cost>
<sender_id>sender</sender_id>
<status_name>status_name</status_name>
<message>message</message>
<comment>comment</comment>
<type>type</type>
<sms_cnt>sms_cnt</sms_cnt>
</sms>
|
- при fmt = 3 и all = 1:
{
"status": <status>,
"last_date": "<last_date>",
"last_timestamp": <last_timestamp>,
"flag": <flag>,
"err": <err>,
"send_date": "<send_date>",
"send_timestamp": <send_timestamp>,
"phone": "<phone>",
"cost": "<cost>",
"sender_id": "<sender>",
"status_name": "<status_name>",
"message": "<message>",
"comment": "<comment>",
"type": <type>,
"sms_cnt": <sms_cnt>
} |
- при fmt = 0 и all = 2:
Status = <status>, check_time = <last_date>, err = <err>, send_date = <send_date>, phone = <phone>, mccmnc = <mccmnc>, country = <country>, operator = <operator>, operator_orig= <operator_orig>, region = <region>, cost = <cost>, sender_id = <sender>, status_name = <status_name>, message = <message>, comment = <comment>, type = <type>
|
- при fmt = 1 и all = 2:
<status>,<last_timestamp>,<err>,<send_timestamp>,<phone>,<country>,<operator>,<region>,<cost>,<sender>,<status_name>,<message>, <comment>, <type>
|
- при fmt = 2 и all = 2:
<sms>
<status>status</status>
<last_date>last_date</last_date>
<last_timestamp>last_timestamp</last_timestamp>
<flag>flag</flag>
<err>err</err>
<send_date>send_date</send_date>
<send_timestamp>send_timestamp</send_timestamp>
<phone>phone</phone>
<cost>cost</cost>
<sender_id>sender</sender_id>
<status_name>status_name</status_name>
<message>message</message>
<comment>comment</comment>
<mccmnc>mccmnc</mccmnc>
<country>country</country>
<operator>operator</operator>
<operator_orig>operator_orig</operator_orig>
<region>region</region>
<type>type</type>
<sms_cnt>sms_cnt</sms_cnt>
</sms>
|
- при fmt = 3 и all = 2:
{
"status": <status>,
"last_date": "<last_date>",
"last_timestamp": <last_timestamp>,
"flag": <flag>,
"err": <err>,
"send_date": "<send_date>",
"send_timestamp": <send_timestamp>,
"phone": "<phone>",
"cost": "<cost>",
"sender_id": "<sender>",
"status_name": "<status_name>",
"message": "<message>",
"comment": "<comment>",
"mccmnc": "<mccmnc>",
"country": "<country>",
"operator": "<operator>",
"operator_orig": "<operator_orig>",
"region": "<region>",
"type": <type>,
"sms_cnt": <sms_cnt>
} |
Где:
<status> – код статуса (список)
<last_date> – дата последнего изменения статуса. Формат DD.MM.YYYY hh:mm:ss.
<last_timestamp> – штамп времени последнего изменения статуса.
<flag> – флаг в виде 2-х байтового числа, содержащий различную информацию о сообщении. Возможны комбинации значений битов разных характеристик.
Биты 0-3 (тип сообщения): 0 – SMS, 1 – Flash-SMS, 2 – Бинарное SMS, 3 – Wap-push, 4 – HLR-запрос, 5 – Ping-SMS, 6 – MMS, 7 – Звонок, 8 – E-mail,
10 – Viber, 12 – Соцсети.
Бит 5 – оплата сообщения со второго баланса.
Бит 8 – признак шаблонного сообщения.
Биты 10,9 – тип шаблонного сообщения (00 - сервисное, 01 - транзакционное, 10 - авторизационное, 11 - рекламное).
<err> – код ошибки, если сообщение не было доставлено.
<send_date> – дата отправки сообщения (формат DD.MM.YYYY hh:mm:ss).
<send_timestamp> – штамп времени отправки сообщения.
<phone> – номер телефона абонента или e-mail адрес.
<country> – название страны регистрации номера абонента.
<operator> – текущий сотовый оператор абонента.
<operator_orig> – оператор абонента по мобильному коду до портирования номера.
<region> – регион регистрации номера абонента.
<cost> – стоимость сообщения.
<sender> – имя отправителя.
<status_name> – название статуса.
<message> – текст сообщения.
<comment> – комментарий сообщения.
<mccmnc> – числовой код страны абонента плюс числовой код оператора абонента.
<type> – тип сообщения (0 – SMS, 1 – Flash-SMS, 2 – Бинарное SMS, 3 – Wap-push, 4 – HLR-запрос, 5 – Ping-SMS, 6 – MMS, 7 –
Звонок, 8 – E-mail, 10 – Viber, 12 – Соцсети).
<sms_cnt> – количество частей в SMS-сообщении (либо секунд в голосовом сообщении).
Ответы для HLR-запросов:
- при fmt = 0 и all = 0:
Status = <status>, check_time = <check_time>, err = <err>, imsi = <imsi>, msc = <msc>, mcc = <mcc>, mnc = <mnc>, cn = <cn>, net = <net>, rcn = <rcn>, rnet = <rnet> |
- при fmt = 1 и all = 0: <status>,<last_timestamp>,<err>,<imsi>,<msc>,<mcc>,<mnc>,<cn>,<net>,<rcn>,<rnet>
- при fmt = 2 и all = 0:
<sms>
<status>status</status>
<last_date>last_date</last_date>
<last_timestamp>last_timestamp</last_timestamp>
<flag>flag</flag>
<err>err</err>
<imsi>imsi</imsi>
<msc>msc</msc>
<mcc>mcc</mcc>
<mnc>mnc</mnc>
<cn>cn</cn>
<net>net</net>
<rcn>rcn</rcn>
<rnet>rnet</rnet>
</sms> |
- при fmt = 3 и all = 0:
{
"status": <status>,
"last_date": "<last_date>",
"last_timestamp": <last_timestamp>,
"flag": <flag>,
"err": <err>,
"imsi": "<imsi>",
"msc": "<msc>",
"mcc": "<mcc>",
"mnc": "<mnc>",
"cn": "<cn>",
"net": "<net>",
"rcn": "<rcn>",
"rnet": "<rnet>"
} |
- при fmt = 0 и all = 1:
Status = <status>, check_time = <check_time>, err = <err>, imsi = <imsi>, msc = <msc>, mcc = <mcc>, mnc = <mnc>, cn = <cn>, net = <net>, rcn = <rcn>, rnet = <rnet>, send_date = <send_date>, phone = <phone>, cost = <cost>, sender_id = <sender_id>, status_name = <status_name>, message = <message>, type = <type> |
- при fmt = 1 и all = 1:
<status>,<last_timestamp>,<err>,<imsi>,<msc>,<mcc>,<mnc>,<cn>,<net>,<rcn>,<rnet>,
<send_timestamp>,<phone>,<cost>,<sender_id>,<status_name>,<message>,<type> |
- при fmt = 2 и all = 1:
<sms>
<status>status</status>
<last_date>last_date</last_date>
<last_timestamp>last_timestamp</last_timestamp>
<flag>flag</flag>
<err>err</err>
<imsi>imsi</imsi>
<msc>msc</msc>
<mcc>mcc</mcc>
<mnc>mnc</mnc>
<cn>cn</cn>
<net>net</net>
<rcn>rcn</rcn>
<rnet>rnet</rnet>
<send_date>send_date</send_date>
<send_timestamp>send_timestamp</send_timestamp>
<phone>phone</phone>
<cost>cost</cost>
<sender_id>sender_id</sender_id>
<status_name>status_name</status_name>
<message>message</message>
<type>type</type>
</sms> |
- при fmt = 3 и all = 1:
{
"status": <status>,
"last_date": "<last_date>",
"last_timestamp": <last_timestamp>,
"flag": <flag>,
"err": <err>,
"imsi": "<imsi>",
"msc": "<msc>",
"mcc": "<mcc>",
"mnc": "<mnc>",
"cn": "<cn>",
"net": "<net>",
"rcn": "<rcn>",
"rnet": "<rnet>",
"send_date": "<send_date>",
"send_timestamp": <send_timestamp>,
"phone": "<phone>",
"cost": "<cost>",
"sender_id": "<sender>",
"status_name": "<status_name>",
"message": "<message>",
"type": <type>
} |
- при fmt = 0 и all = 2:
Status = <status>, check_time = <check_time>, err = <err>, imsi = <imsi>,
msc = <msc>, mcc = <mcc>, mnc = <mnc>, cn = <cn>, net = <net>, rcn = <rcn>, rnet = <rnet>,
send_date = <send_date>, phone = <phone>, country = <country>, operator = <operator>, region = <region>, cost = <cost>,
sender_id = <sender_id>, status_name = <status_name>, message = <message>, type = <type> |
- при fmt = 1 и all = 2:
<status>,<last_timestamp>,<err>,<imsi>,<msc>,<mcc>,<mnc>,<cn>,<net>,<rcn>,<rnet>,
<send_timestamp>,<phone>,<country>,<operator>,<region>,<cost>,<sender_id>,<status_name>,<message>,<type> |
- при fmt = 2 и all = 2:
<sms>
<status>status</status>
<last_date>last_date</last_date>
<last_timestamp>last_timestamp</last_timestamp>
<flag>flag</flag>
<err>err</err>
<imsi>imsi</imsi>
<msc>msc</msc>
<mcc>mcc</mcc>
<mnc>mnc</mnc>
<cn>cn</cn>
<net>net</net>
<rcn>rcn</rcn>
<rnet>rnet</rnet>
<send_date>send_date</send_date>
<send_timestamp>send_timestamp</send_timestamp>
<phone>phone</phone>
<cost>cost</cost>
<sender_id>sender_id</sender_id>
<status_name>status_name</status_name>
<message>message</message>
<country>country</country>
<operator>operator</operator>
<region>region</region>
<type>type</type>
</sms> |
- при fmt = 3 и all = 2:
{
"status": <status>,
"last_date": "<last_date>",
"last_timestamp": <last_timestamp>,
"flag": <flag>,
"err": <err>,
"imsi": "<imsi>",
"msc": "<msc>",
"mcc": "<mcc>",
"mnc": "<mnc>",
"cn": "<cn>",
"net": "<net>",
"rcn": "<rcn>",
"rnet": "<rnet>",
"send_date": "<send_date>",
"send_timestamp": <send_timestamp>,
"phone": "<phone>",
"cost": "<cost>",
"sender_id": "<sender>",
"status_name": "<status_name>",
"message": "<message>",
"country": "<country>",
"operator": "<operator>",
"region": "<region>",
"type": <type>
} |
Где:
<status> – код статуса (список)
<last_date> – дата последнего изменения статуса. Формат DD.MM.YYYY hh:mm:ss.
<last_timestamp> – штамп времени последнего изменения статуса.
<flag> – флаг в виде 2-х байтового числа, содержащий различную информацию о сообщении. Возможны комбинации значений битов разных характеристик.
Биты 0-3 (тип сообщения): 0 – SMS, 1 – Flash-SMS, 2 – Бинарное SMS, 3 – Wap-push, 4 – HLR-запрос, 5 – Ping-SMS, 6 – MMS, 7 – Звонок, 8 – E-mail,
10 – Viber, 12 – Соцсети.
Бит 5 – оплата сообщения со второго баланса.
Бит 8 – признак шаблонного сообщения.
<err> – код HLR-ошибки или статуса абонента (список).
<imsi> – уникальный код IMSI SIM-карты абонента.
<msc> – номер сервис-центра оператора, в сети которого находится абонент.
<mcc> – числовой код страны абонента.
<mnc> – числовой код оператора абонента.
<cn> – название страны регистрации абонента.
<net> – название оператора регистрации абонента.
<rcn> – название роуминговой страны абонента при нахождении в чужой сети.
<rnet> – название роумингового оператора абонента при нахождении в чужой сети.
<send_date> – дата отправки сообщения (формат DD.MM.YYYY hh:mm:ss).
<send_timestamp> – штамп времени отправки сообщения.
<phone> – номер телефона абонента.
<country> – название страны регистрации номера абонента.
<operator> – название оператора абонента.
<region> – регион регистрации номера абонента.
<cost> – стоимость сообщения.
<sender> – имя отправителя.
<status_name> – название статуса.
<message> – текст сообщения.
<type> – тип сообщения (для HLR равен 4).
Если сообщение не найдено или находится в архивной базе (значение статуса равно -3), то для fmt = 0,2,3 возвращается код статуса в
соответствующем формате. Для fmt = 1 возвращается ответ в формате статуса обычного сообщения.
При множественном запросе статусов:
- для fmt = 0 и fmt = 1 в результате возвращается список строк, каждая из которых содержит информацию о статусе соответствующего сообщения.
- для fmt = 2 формат возвращаемых статусов аналогичен формату для одиночных сообщений, при этом весь список статусов заключается в тег "<list>".
- для fmt = 3 формат также аналогичен формату для одиночных сообщений, статусы перечисляются через запятую, и весь список обрамляется
квадратными скобками.
В случае множественного запроса статусов при значении параметра all = 1 или all = 2 для каждого статуса дополнительно возвращается идентификатор
сообщения. При all = 0 дополнительно возвращается идентификатор сообщения и номер телефона.Коды статусовВозможные варианты кодов статусов сообщений или HLR-запросов (значения <status>):
Код | Название | Описание
|
---|
-3 | Сообщение не найдено | Возникает, если для указанного номера телефона и ID сообщение не найдено.
|
---|
-2 | Остановлено | Возникает у сообщений из рассылки, которые не успели уйти оператору до момента временной остановки данной рассылки на странице Рассылки и задания.
|
---|
-1 | Ожидает отправки | Если при отправке сообщения было задано время получения абонентом, то до этого времени сообщение будет
находиться в данном статусе, в других случаях сообщение в этом статусе находится непродолжительное время перед отправкой на SMS-центр.
|
---|
0 | Передано оператору | Сообщение было передано на SMS-центр оператора для доставки.
|
---|
1 | Доставлено | Сообщение было успешно доставлено абоненту.
|
---|
2 | Прочитано | Сообщение было прочитано (открыто) абонентом. Данный статус возможен для e-mail-сообщений, имеющих формат html-документа.
|
---|
3 | Просрочено | Возникает, если время "жизни" сообщения истекло, а оно так и не было доставлено получателю, например, если абонент
не был доступен в течение определенного времени или в его телефоне был переполнен буфер сообщений.
|
---|
4 | Нажата ссылка | Сообщение было доставлено, и абонентом была нажата короткая ссылка, переданная в сообщении.
Данный статус возможен при включенных в настройках опциях "Автоматически сокращать ссылки в сообщениях" и "отслеживать номера абонентов".
|
---|
20 | Невозможно доставить | Попытка доставить сообщение закончилась неудачно, это может быть вызвано разными причинами, например,
абонент заблокирован, не существует, находится в роуминге без поддержки обмена SMS, или на его телефоне не поддерживается прием SMS-сообщений.
|
---|
22 | Неверный номер | Неправильный формат номера телефона.
|
---|
23 | Запрещено | Возникает при срабатывании ограничений на отправку дублей, на частые сообщения на один номер (флуд), на номера из
черного списка, на запрещенные спам фильтром тексты или имена отправителей (Sender ID).
|
---|
24 | Недостаточно средств | На счете Клиента недостаточная сумма для отправки сообщения.
|
---|
25 | Недоступный номер | Телефонный номер не принимает SMS-сообщения, или на этого оператора нет рабочего маршрута.
|
---|
Запрос статусов сообщений необходимо осуществлять в течение суток с момента отправки.
По истечении данного времени сообщения помещаются в архивную базу. В 03:00 по московскому времени переносятся
сообщения с конечным статусом, отправленные до 18:00 прошедшего дня. Для возможности получения реальных статусов
таких сообщений необходимо обратиться в службу поддержки.
Также сервер не принимает более пяти одинаковых запросов на получение статуса одного и того же сообщения или более одного массового запроса
в течение минуты для снижения нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.
Коды ошибок в статусеВозможные коды ошибок в статусе сообщений или HLR-запросов (значения <err>):
Код | Название | Описание
|
---|
0 | Нет ошибки | Абонент существует и доступен.
|
---|
1 | Абонент не существует | Указанный номер телефона не существует.
|
---|
6 | Абонент не в сети | Телефон абонента отключен или находится вне зоны действия сети.
|
---|
11 | Не подключена услуга | Означает, что абонент не может принять SMS-сообщение. Например, услуга не подключена,
или абонент находится в роуминге, где не активирован прием сообщений, или у оператора абонента не налажен обмен SMS с
текущим роуминговым оператором. Также это может быть городской номер без приема сообщений.
|
---|
12 | Ошибка в телефоне абонента | Не удается доставить сообщение абоненту из-за ошибки в телефонном аппарате или SIM-карте.
|
---|
13 | Абонент заблокирован | Возникает, например, если на счету абонента нулевой или отрицательный баланс, и
он находится в роуминге, или заблокирован оператором за продолжительную неуплату либо добровольно самим абонентом. Также
данная ошибка может возвращаться при повреждении SIM-карты либо неправильном вводе PIN и PUK-кодов SIM-карты.
|
---|
21 | Нет поддержки сервиса | Аппарат абонента не поддерживает работу с данной услугой (сервисом).
|
---|
200 | Виртуальная отправка | Данное уведомление появляется под статусом сообщения в случае отправки
сообщения в режиме тестирования (при установленной в настройках галочке "Режим тестирования (виртуальная отправка без
оплаты)").
|
---|
219 | Замена sim-карты | Ошибка отправки сообщения в связи с заменой абонентом sim-карты. После физической замены sim-карты абоненту заблокирован прием сообщений от буквенных имен отправителей на 24 часа. Блокировка может быть снята путем пополнения баланса на 100 рублей.
|
---|
220 | Переполнена очередь у оператора | Указанная ошибка может возникать в случае, когда абонент недоступен
для приема SMS, но сообщения продолжают приходить оператору и происходит переполнение внутренней очереди сообщений
для данного абонента. В редких случаях возможно появление ошибки в результате сбоя в сети самого оператора или переполнении
общей очереди сообщений. Во всех подобных ситуациях система с определенными интервалами несколько раз пытается отправить
указанные сообщения повторно.
|
---|
237 | Абонент не отвечает | Возникает, если в процессе попытки дозвона абонент не взял трубку.
|
---|
238 | Нет шаблона | Возникает, если отправка сообщения возможна только по определенному шаблону, а отправляемое
сообщение ему не удовлетворяет.
|
---|
239 | Запрещенный ip-адрес | Возникает при попытке отправки сообщения с ip-адреса, не входящего в список ip-адресов,
разрешенных Клиентом для отправки. Также может возникать при попытке отправки сообщения с ip-адреса, ранее не используемого
для отправки сообщений и входов в личный кабинет.
|
---|
240 | Абонент занят | Возникает при передаче голосового сообщения абоненту, если линия занята или абонент
отменил вызов.
|
---|
241 | Ошибка конвертации | При преобразовании текста или звукового файла в конечный формат для передачи
абоненту голосового сообщения произошла ошибка конвертации звука. Также данная ошибка может возникать при передаче
SMS-сообщения отдельными частями, когда оператору переданы не все части.
|
---|
242 | Зафиксирован автоответчик | Означает, что во время отправки голосового сообщения на стороне абонента был
зафиксирован автоответчик.
|
---|
243 | Не заключен договор | Возникает при попытке отправки рассылок рекламного или массового характера без
заключенного договора.
|
---|
244 | Рассылка запрещена | Означает, что для данного Клиента запрещена отправка массовых и рекламных рассылок,
либо в тексте сообщения встретилась запрещенная ссылка.
|
---|
245 | Статус не получен | В течение суток статус доставки не был получен от оператора, в этом
случае нельзя точно сказать, было сообщение доставлено или нет.
|
---|
246 | Ограничение по времени | Если в личном кабинете в пункте "Настройки" во вкладке "Лимиты и ограничения"
установлено "Время отправки" и галочка "запретить отправку в другое время", то при попытке отправки SMS-сообщений в период
времени, отличный от указанного в поле "Время отправки", отправка сообщений будет запрещаться с указанием данной ошибки.
|
---|
247 | Превышен лимит сообщений | Превышен общий суточный лимит сообщений, указанный Клиентом в личном кабинете
в пункте "Настройки".
|
---|
248 | Нет маршрута | Означает, что на данный номер отправка сообщений недоступна в нашем сервисе.
Например, ввели несуществующий мобильный код, либо для указанного номера и текста нет рабочего SMS-шлюза.
|
---|
249 | Неверный формат номера | Возникает, когда мобильный код указанного номера и соответствующая этому коду
длина номера неверны.
|
---|
250 | Номер запрещен настройками | Номер попал под ограничения, установленные Клиентом для мобильных номеров в
личном кабинете в пункте "Настройки".
|
---|
251 | Превышен лимит на один номер | Превышен суточный лимит сообщений на один номер. Лимит устанавливается
Клиентом в личном кабинете в пункте "Настройки". Также такая ошибка возможна при отправке более 50 сообщений одному абоненту,
которые были отправлены с перерывом между сообщениями менее 30 секунд.
|
---|
252 | Номер запрещен | Возникает, например, при попытке указания Клиентом одного из наших федеральных номеров в
качестве получателя SMS-сообщения.
|
---|
253 | Запрещено спам-фильтром | Если текст сообщения содержит нецензурные выражения и оскорбления, призывы отправить
sms и некоторые другие запрещенные тексты, то отправка сообщения заблокируется. Также запрещено указывать в качестве
отправителя короткие платные номера, номер получателя сообщений, названия операторов, чужих интернет-ресурсов, компаний и
государственных организаций.
|
---|
254 | Незарегистрированный sender id | Данная ошибка возникает при попытке отправки сообщения от незарегистрированного
имени отправителя.
|
---|
255 | Отклонено оператором | Оператор отклонил сообщение без указания точного кода ошибки. Такое бывает, например,
когда номер не принадлежит ни одному мобильному оператору, т.е. с несуществующим кодом, либо по какой-то другой причине оператор
не может доставить сообщение.
|
---|
Возможные коды ошибок в статусе e-mail сообщений (значения <err>):
Код | Название | Описание
|
---|
0 | Нет ошибки | Получатель существует и доступен.
|
---|
1 | Адресат не существует | Указанный e-mail адрес не существует.
|
---|
2 | Переполнен почтовый ящик | Почтовый сервер получателя отклонил сообщение с указанным кодом ошибки.
|
---|
3 | Сервер получателя не найден | Домен, указанный в качестве почтового сервера, не найден.
|
---|
4 | Почтовый ящик заблокирован | От почтового сервера получателя вернулась ошибка о невозможности доставки
сообщения по причине блокировки ящика.
|
---|
239 | Запрещенный ip-адрес | Возникает при попытке отправки сообщения с ip-адреса, не входящего в список ip-адресов,
разрешенных Клиентом для отправки. Также может возникать при попытке отправки сообщения с ip-адреса, ранее не используемого
для отправки сообщений и входов в личный кабинет.
|
---|
245 | Статус не получен | В течение суток статус доставки не был получен от почтового сервера получателя, в этом
случае нельзя точно сказать, было сообщение доставлено или нет.
|
---|
248 | Нет маршрута | Означает, что на данный e-mail адрес отправка сообщений недоступна в нашем сервисе.
Например, для указанного адреса и текста нет рабочего e-mail шлюза.
|
---|
249 | Неверный формат адреса | Возникает, когда ввели некорректный по формату e-mail адрес получателя.
|
---|
252 | E-mail адрес запрещен | Возникает, например, при нахождении указанного e-mail адреса в черном списке.
|
---|
253 | Запрещено спам-фильтром | Если текст сообщения содержит нецензурные выражения и оскорбления, призывы отправить
sms или e-mail и некоторые другие запрещенные тексты, то отправка сообщения заблокируется. Также запрещено указывать в качестве
отправителя e-mail адрес получателя сообщения, адреса чужих интернет-ресурсов, компаний и государственных организаций.
|
---|
254 | Незарегистрированный отправитель | Данная ошибка возникает при попытке отправки сообщения от незарегистрированного
e-mail адреса отправителя.
|
---|
255 | Отклонено сервером получателя | Почтовый сервер получателя отклонил сообщение без указания точного кода ошибки. Такое бывает, например,
при возникновении внутренней ошибки сервера, когда он не может обработать сообщение.
|
---|
Удаление сообщенияДля удаления сообщения необходимо вызвать методом GET или POST скрипт запроса статуса, указав команду del:
https://smsc.kz/sys/status.php?del=1&login=<login>&psw=<password>&phone=<phone>&id=<sms_id>
Описание параметров, передаваемых Серверу, и возвращаемых им ошибок аналогичное приведенному для функции запроса статуса.
В случае успешного запроса Сервер возвращает ответ в виде строки:
- при fmt = 0,1: OK
- при fmt = 2:
<result>OK</result>
- при fmt = 3:
Удаление сообщений необходимо производить до переноса в архивную базу.
|