Документация системы MOBIPACE

HTTP API 4.0

Содержание

HTTP API 4.0 является платформо-независимым.

Это предоставляет возможность интегрировать продкут в любое решение независимо от применяемых технологий и языков программирования.

HTTP API версии 4.0 предоставляет следующие возможности:

Отправка SMS сообщений в формате ASCII (латиница)
Отправка SMS сообщений в формате UNICODE
Отправка длинных (составных) SMS сообщений
Отправка VIBER сообщений
Отслеживание статуса отправленного SMS или VIBER сообщения
Планирование отправки сообщений
Распределение скорости отправки сообщений
Запрос баланса
Предварительный расчет стоимости отправки сообщений
Запрос зарегистрированных имен SMS или VIBER отправителей

Передача данных осуществляется путём обмена данными в рамках протокола прикладного уровня. Обмен данными производится по протоколу HTTPS, т.е. HTTP (RFC 2068, RFC 2616) с обязательным использованием прослойки SSL/TLS.

Соединение с сервером устанавливается по порту 444.

Запросы отправляются методом POST в формате JSON.

В рамках использования HTTP API 4.0 действуют следующие ограничения:

1. В рамках одного запроса поддерживается отправка SMS сообщений не более чем 20 000 получателям.

2. В рамках одного запроса поддерживается отправка VIBER сообщений не более чем 100 000 получателям.

3. В рамках одного запроса поддерживается проверка не более чем 20 000 статусов.

4. HTTP API 4.0 единовременно принимает только один запрос для одного и того же аккаунта.

5. Номер Получателя должен указываться в международном формате (макс. 15 цифр).

6. Максимальная длина символов отправляемого SMS сообщения 500 символов (в том числе пробелы и знаки препинания).

7. Максимальная длина символов отправляемого VIBER сообщения 1000 символов (в том числе пробелы и знаки препинания).

8. В случае отправляемого VIBER сообщения. Если указан текст кнопки но не указан URL, сообщение не будет отправлено.

9. Для успешной отправки сообщений на сервер необходимо также:

После регистрации установить валюту аккаунта в системе MOBIPACE, в разделе “Персональные данные ”.
Осуществлять отправку сообщений только с зарегистрированных имен отправителей. Имена отправителей необходимо предварительно согласовать с Вашим менеджером.

10. По умолчанию, время системы MOBIPACE установлено в формате UTC (Всемирное координированное время). В случае если Вы хотите планировать и отправлять сообщения с учетом вашего локального времени, Вам необходимо установиить свой часовой пояс в системе MOBIPACE, в разделе “Персональные данные”.

Передача данных осуществляется путём обмена данными в рамках протокола прикладного уровня. Обмен данными производится по протоколу HTTPS, т.е. HTTP (RFC 2068, RFC 2616) с обязательным использованием прослойки SSL/TLS.

Соединение с сервером устанавливается по порту 444.

Запросы отправляются методом POST в формате JSON.

Существует одиннадцать методов запросов к HTTP API 4.0.

Authorize

SendSMS

CalculateSMS

QuerySMSBalance

QuerySMSMessages

RegisteredSMSSenderNames

SendViber

CalculateViber

QueryViberBalance

QueryViberMessages

RegisteredViberSenderNames

Для каждого из одиннадцати методов запросов используется свой URL.

Данные, которыми обменивается ПО Партнера с сервером MOBIPACE должны быть интерпретированы в формате JSON.

Все ответы, передаваемые Партнёрскому ПО, также интерпретированы в формате JSON. Партнер должен обеспечить корректное распознавание JSON данных, получаемых от сервера MOBIPACE.

Максимальное время ожидания ответа на любой запрос должно составлять 60 секунд. В случае отсутствия ответа на запрос, необходимо обязательно проверить состояние соединения с системой

Для отправки сообщений предварительно необходимо пройти авторизацию на сервере MOBIPACE.

При успешной авторизации, система открывает сессию с присвоением уникального ID. Данный ID Партнер должен использовать при обращении с запросом к HTTP API 4.0.

Сервер MOBIPACE поддерживает сессию в течение 20 минут с момента последнего запроса. По истечении данного срока сервер автоматически закрывает сессию, после чего необходимо пройти процесс авторизации заново.

Интернет-адрес для прохождения авторизации:

https://api.mobipace.com:444/v4/Authorize

Запросы отправляются методом POST в формате JSON.

Параметры, передаваемые в запросе на прохождение авторизации:

Параметр	Тип	Описание	Обязательный
Username	строка	Имя пользователя в системе MOBIPACE	ДА
Password	строка	Пароль в системе MOBIPACE	ДА

Ответ системы MOBIPACE:

Параметр	Тип	Описание
StatusCode	целое число	Код статуса обработки запроса
Status	строка	Текстовое значение статуса обработки запроса
SessionId	строка	ID сессии присвоенный партнеру при успешной авторизации

Пример JSON запроса на прохождение авторизации:

{
   "Username" : "mobipace@mobipace.com",
   "Password" : "123456"
}

Пример ответа сервера:

{
  "StatusCode": 101,
  "Status": "Success",
  "SessionId": "4060b129-2d75-4b7e-9c3a-61b7769a5d2b"
}

Метод предназначен для отправки SMS сообщений на сервер MOBIPACE.

Для отправки данных предварительно необходимо пройти авторизацию на сервере MOBIPACE.
В рамках одного запроса поддерживается отправка SMS сообщений не более чем 20 000 получателям.

Интернет-адрес для отправки SMS сообщений:

https://api.mobipace.com:444/v4/SendSMS

Запросы отправляются методом POST в формате JSON.

Параметры, передаваемые в запросе на отправку SMS сообщений:

Параметр	Тип	Описание	Обязательный
SessionId	строка	ID сессии полученный после успешной авторизации	ДА
Sender	строка	Имя отправителя сообщений (Имена отправителей необходимо предварительно согласовать с Вашим менеджером)	ДА
ScheduledDate	строка	Дата и время отправки сообщений. Формат даты и времени “yyyy-MM-dd HH:mm:ss”	НЕТ
SendWithinHours	целое число	Параметр лимитирующий скорость отправки. Отправка сообщений распределяется на время указанное в параметре. Допустимые значения 0-6 (часов). 0 означает отсутствие лимита.	НЕТ
Messages	коллекция[Message]	Массив сообщений для отправки	ДА

Структура коллекции [Message]:

Параметр	Тип	Описание	Обязательный
Recipient	строка	Номер получателя в международном формате без знаков “+” или “00”.	ДА
Body	строка	Текст отправляемого сообщения (макс. 500 символов)	ДА
Reference	uniqueidentifier	Уникальный ID присвоенный сообщению Вашей системой для дальнейшего отслеживания статусов	НЕТ

Ответ системы MOBIPACE:

Параметр	Тип	Описание
StatusCode	целое число	Код статуса обработки запроса
Status	строка	Текстовое значение статуса обработки запроса
MessageCount	целое число	Количество принятых сообщений
PartCount	целое число	Суммарное количество сегментов принятых сообщений
AveragePrice	десятичное число	Средняя цена
TotalPrice	десятичное число	Сумма, удержанная с текущего баланса

Пример JSON запроса (только с указанием обязательных параметров):

{
  "SessionId" : "256B057E-DBE5-43EF-938B-D1C19B858DE1",
  "Sender" : "MOBIPACE",
  "Messages" : [
                            { "Recipient" : "XXXXXXXXXXX", "Body" : "SMS Message 1"},
                            { "Recipient" : "XXXXXXXXXXX", "Body" : "SMS Message 2"},
                            ….
                            { "Recipient" : "XXXXXXXXXXX", "Body" : "SMS Message n"}
                        ]
}

Пример JSON запроса (с указанием всех параметров):

{
  "SessionId" : "9E280141-86DF-438F-B76C-48A7ED5B1DB8",
  "ScheduledDate" :"2021-07-25 18:20:00",
  "SendWithinHours" : "1",
  "Sender" : "MOBIPACE",
  "Messages" : [
                             {"Recipient" : "XXXXXXXXXX", "Body" : "SMS Message 1", "Reference" : "unique reff 1" },
                             {"Recipient" : "XXXXXXXXXX", "Body" : "SMS Message 2", "Reference" : "unique reff 2" },
                             ….
                             {"Recipient" : "XXXXXXXXXX", "Body" : "SMS Message n", "Reference” : "unique reff n" }
                         ]
}

Пример ответа сервера:

{
  "StatusCode" : 101,
  "Status" : "Success",
  "MessageCount" : 10,
  "PartCount" : 20,
  "ValidMessagesCount" : 10,
  "ValidPartsCount" : 20,
  "AveragePrice" : 25.00,
  "TotalPrice" : 500.00
}

Метод предназначен для расчета стоимости отправки SMS сообщений.

Данный метод осуществляет расчет стоимости отправки указанного количества SMS сообщений, без осуществления их отправки.
В рамках одного запроса поддерживается расчет стоимости отправки SMS сообщений не более чем 20 000 получателям.

Интернет-адрес для расчета стоимости отправки SMS сообщений:

https://api.mobipace.com:444/v4/CalculateSMS

Запросы отправляются методом POST в формате JSON.

Используемые параметры, передаваемые в запросе, полностью совпадают с параметрами, передаваемыми в методе SendSMS.

Для отправки данных предварительно необходимо пройти авторизацию на сервере MOBIPACE.

Метод предназначен для запроса баланса предназначенного для отправки SMS сообщений.

Для отправки данных предварительно необходимо пройти авторизацию на сервере MOBIPACE.

Интернет-адрес для запроса баланса отправки SMS сообщений:

https://api.mobipace.com:444/v4/QuerySMSBalance

Запросы отправляются методом POST в формате JSON.

Параметры, передаваемые в запросе для запроса баланса предназначенного для отправки SMS сообщений:

Параметр	Тип	Описание	Обязательный
SessionId	строка	ID сессии полученный после успешной авторизации	ДА

Ответ системы MOBIPACE:

Параметр	Тип	Описание
StatusCode	целое число	Код статуса обработки запроса
Status	строка	Текстовое значение статуса обработки запроса
Balance	десятичное число	Актуальный баланс для отправки SMS сообщений
BalanceNegativeLimit	десятичное число	Лимит кредита для отправки SMS сообщений
AvailableFunds	десятичное число	Значение средств возможных для использования с учетом кредита

Пример JSON запроса (с указанием всех параметров):

{
  "SessionId": "30044E2C-1F62-41E3-8DB9-D980080A3AB3"
}

Пример ответа сервера:

{
  "StatusCode": 101,
  "Status": "Success",
  "Balance": "1300.30",
  "BalanceNegativeLimit": "-1000"
  "AvailableFunds ": "2300.30"
}

Метод предназначен для запроса актуальных статусов отправленных SMS сообщений.

Метод возвращает все статусы запрошенных SMS-сообщений, отправленных в течение последних 48 часов.
В рамках одного запроса поддерживается проверка не более чем 20 000 статусов.

Важно! Для корректного использования функционала данного метода, необходимо при использовании метода SendSMS указывать уникальные ID для каждого SMS сообщения. Уникальные ID указваются в параметре Reference колекции [Message] (см. описание метода SendSMS).

Интернет-адрес для запроса актуальных статусов SMS сообщений:

https://api.mobipace.com:444/v4/QuerySMSMessages

Запросы отправляются методом POST в формате JSON.

Параметры, передаваемые в запросе на получение актуальных статусов отправленных SMS сообщений:

Параметр	Тип	Описание	Обязательный
SessionId	строка	ID сессии полученный после успешной авторизации	ДА
References	коллекция[строка]	Массив уникальных ID присвоенные сообщениям вашей системой при использовании метода SendSMS	ДА

Ответ системы MOBIPACE:

Параметр	Тип	Описание
StatusCode	целое число	Код статуса обработки запроса
Status	строка	Текстовое значение статуса обработки запроса
MessageStatuses	коллекция[MessageStatus]	Массив запрошенных статусов сообщений

Структура коллекции [MessageStatus]:

Параметр	Тип	Описание
Reference	строка	Уникальный ID присвоенный сообщению вашей системой при использовании метода SendSMS
StatusCode	строка	Код статуса сообщения
Status	строка	Текстовое значение статуса сообщения

Пример JSON запроса (с указанием всех параметров):

{
   "SessionId": "6A0B57EE-A69D-4649-A145-3C504379E821",
   "References": [
                             "unique reff 1",
                             "unique reff 2",
                             …,
                             "unique reff n"
                           ]
}

Пример ответа сервера:

{
  "StatusCode" : 101,
  "Status" : "Success",
  "MessageStatuses" : [
                                         { "Reference" : "unique reff 1", "StatusCode" : 2,   "Status" : "Scheduled" },
                                         { "Reference" : "unique reff 2", "StatusCode" : 100, "Status" : "Delivered" },
                                         ……
                                         { "Reference" : "unique reff n", "StatusCode" : 101, "Status" : "Undeliverable" }
                                     ]
}

Метод предназначен для отправки VIBER сообщений на сервер MOBIPACE.

Для отправки данных предварительно необходимо пройти авторизацию на сервере MOBIPACE.
В рамках одного запроса поддерживается отправка VIBER сообщений не более чем 100 000 получателям.

Интернет-адрес для отправки VIBER сообщений:

https://api.mobipace.com:444/v4/SendViber

Запросы отправляются методом POST в формате JSON.

Параметры, передаваемые в запросе на отправку VIBER сообщений:

Параметр	Тип	Описание	Обязательный
SessionId	строка	ID сессии полученный после успешной авторизации	ДА
Sender	строка	Имя отправителя VIBER сообщений (Имена отправителей необходимо предварительно согласовать с Вашим менеджером)	ДА
ScheduledDate	строка	Дата и время отправки сообщений ”Формат даты и времени “yyyy-MM-dd HH:mm:ss”	НЕТ
SendWithinHours	целое число	Параметр определяющий скорость отправки. Отправка сообщений осуществляется в течение указанного времени. Допустимые значения 1-6 (часов)	НЕТ
ViberMessages	коллекция[ViberMessage]	Массив сообщений для отправки	ДА
ValidityPeriod	целое число	Параметр определяющий время жизни и обновления статусов сообщений. Система будет пытаться доставить сообщение и будет обновлять статусы в течение указанного времени. Допустимые значения 10 - 1440 (минут)	ДА

Структура коллекции [ViberMessage]:

Параметр	Тип	Описание	Обязательный
Recipient	строка	Номер получателя в международном формате без знаков “+” или “00”.	ДА
Body	строка	Текст отправляемого сообщения (макс.1000 символов)	ДА
Reference	uniqueidentifier	Уникальный ID присвоенный сообщению Вашей системой для дальнейшего отслеживания статусов	НЕТ
Caption	строка	Текст кнопки для перехода на сайт Партнера	НЕТ
Action	URL	Ссылка на сайт Партнера на который получатель переходит при клике на кнопку	НЕТ
Image	URL	Ссылка на картинку, которая должна быть размещена в сообщении	НЕТ

Ответ системы MOBIPACE:

Параметр	Тип	Описание
StatusCode	целое число	Код статуса обработки запроса
Status	строка	Текстовое значение статуса обработки запроса
MessageCount	целое число	Количество принятых сообщений
ValidMessagesCount	целое число	Количество принятых корректных сообщений
AveragePrice	десятичное число	Средняя цена
TotalPrice	десятичное число	Сумма, удержанная с текущего баланса

Пример JSON запроса (только с указанием обязательных параметров):

{
  "SessionId" : "256B057E-DBE5-43EF-938B-D1C19B858DE1",
  "Sender" : "MOBIPACE",
  "ValidityPeriod" : "1440",
  "ViberMessages" : [
                                     { "Recipient" : "XXXXXXXXXXX", "Body" : "VIBER Message 1"},
                                     { "Recipient" : "XXXXXXXXXXX", "Body" : "VIBER Message 2"},
                                     ….
                                     { "Recipient" : "XXXXXXXXXXX", "Body" : "VIBER Message n"}
                                  ]
}

Пример JSON запроса (с указанием всех параметров):

{
   "SessionId" : "9E280141-86DF-438F-B76C-48A7ED5B1DB8",
   "ScheduledDate" : "2021-07-25 18:20:00",
   "SendWithinHours" : "1",
   "Sender" : "MOBIPACE",
   "ValidityPeriod" : "1440",
   "ViberMessages" : [
                                    {"Recipient" : "XXXXXXXXXX", "Body" : "VIBER Message 1", "Caption" : "Button Text 1", 
                                     "Action" : "http://your-site.com", "Image" : "http://myimage.com", "Reference" : "unique reff 1"},
                                    {"Recipient" : "XXXXXXXXXX", "Body" : "VIBER Message 2", "Caption" : "Button Text 2", 
                                     "Action" : "http://your-site.com", "Image" : "http://myimage.com", "Reference" : "unique reff 2"},
                                     ….
                                    {"Recipient" : "XXXXXXXXXX", "Body" : "VIBER Message n", "Caption" : "Button Text n", 
                                     "Action" : "http://your-site.com", "Image" : "http://myimage.com", "Reference" : "unique reff n"},
                                  ]
}

Пример ответа сервера:

{
  "StatusCode" : 101,
  "Status" : "Success",
  "MessageCount" : 10,
  "ValidMessagesCount" : 10,
  "AveragePrice" : 50.00,
  "TotalPrice" : 500.00
}

Метод предназначен для расчета стоимости отправки VIBER сообщений.

Данный метод осуществляет расчет стоимости отправки указанного количества VIBER сообщений, без осуществления их отправки.
В рамках одного запроса поддерживается расчет стоимости отправки VIBER сообщений не более чем 100 000 получателям.

Интернет-адрес для расчета стоимости отправки VIBER сообщений:

https://api.mobipace.com:444/v4/CalculateViber

Запросы отправляются методом POST в формате JSON.

Используемые параметры, передаваемые в запросе, полностью совпадают с параметрами, передаваемыми в методе SendViber.

Для отправки данных предварительно необходимо пройти авторизацию на сервере MOBIPACE.

Метод предназначен для запроса баланса предназначенного для отправки VIBER сообщений.

Для отправки данных предварительно необходимо пройти авторизацию на сервере MOBIPACE.

Интернет-адрес для запроса баланса отправки VIBER сообщений:

https://api.mobipace.com:444/v4/QueryViberBalance

Запросы отправляются методом POST в формате JSON.

Параметры, передаваемые в запросе для запроса баланса предназначенного для отправки VIBER сообщений:

Параметр	Тип	Описание	Обязательный
SessionId	строка	ID сессии полученный после успешной авторизации	ДА

Ответ системы MOBIPACE:

Параметр	Тип	Описание
StatusCode	целое число	Код статуса обработки запроса
Status	строка	Текстовое значение статуса обработки запроса
Balance	десятичное число	Актуальный баланс для отправки VIBER сообщений
BalanceNegativeLimit	десятичное число	Лимит кредита для отправки VIBER сообщений
AvailableFunds	десятичное число	Значение средств возможных для использования с учетом кредита

Пример JSON запроса (с указанием всех параметров):

{
  "SessionId": "30044E2C-1F62-41E3-8DB9-D980080A3AB3"
}

Пример ответа сервера:

{
  "StatusCode": 101,
  "Status": "Success",
  "Balance": "1300.30",
  "BalanceNegativeLimit": "-1000"
  "AvailableFunds ": "2300.30"
}

Метод предназначен для запроса актуальных статусов отправленных VIBER сообщений.

Метод возвращает все статусы запрошенных VIBER сообщений, отправленных в течение последних 48 часов.
В рамках одного запроса поддерживается проверка не более чем 20 000 статусов.

Важно! Для корректного использования функционала данного метода, необходимо при использовании метода SendViber указывать уникальные ID для каждого VIBER сообщения. Уникальные ID указваются в параметре Reference колекции [ViberMessage] (см. описание метода SendViber).

Интернет-адрес для запроса актуальных статусов VIBER сообщений:

https://api.mobipace.com:444/v4/QueryViberMessages

Запросы отправляются методом POST в формате JSON.

Параметры, передаваемые в запросе на получение актуальных статусов отправленных VIBER сообщений:

Параметр	Тип	Описание	Обязательный
SessionId	строка	ID сессии полученный после успешной авторизации	ДА
References	коллекция[строка]	Массив уникальных ID присвоенные сообщениям вашей системой при использовании метода “SendViber”	ДА

Ответ системы MOBIPACE:

Параметр	Тип	Описание
StatusCode	целое число	Код статуса обработки запроса
Status	строка	Текстовое значение статуса обработки запроса
MessageStatuses	коллекция[MessageStatus]	Массив запрошенных статусов сообщений

Структура коллекции [MessageStatus]:

Параметр	Тип	Описание	Всегда присутствует
Reference	строка	Уникальный ID присвоенный сообщению вашей системой при использовании метода “SendVIBER”	ДА
StatusCode	строка	Код статуса сообщения	ДА
Status	строка	Текстовое значение статуса сообщения	ДА
DeliveryDate	строка	Дата доставки сообщения в формате Unix Time	НЕТ
SeenDate	строка	Дата открытия/прочтения сообщения в формате Unix Time	НЕТ

Пример JSON запроса (с указанием всех параметров):

{
  "SessionId": "6A0B57EE-A69D-4649-A145-3C504379E821",
  "References": [
                           "unique reff 1",
                           "unique reff 2",
                           …,
                           "unique reff n"
                          ]
}

Пример ответа сервера:

{
   "StatusCode" : 101,
   "Status" : "Success",
   "MessageStatuses" : [
                                         { "Reference" : "unique reff 1", "StatusCode" : 2,   "Status" : "Scheduled" },
                                         { "Reference" : "unique reff 2", "StatusCode" : 100, "Status" : "Delivered" },
                                         ……
                                         { "Reference" : "unique reff n", "StatusCode" : 101, "Status" : "Undeliverable" }
                                     ]
}

Коды статусов сообщений и их значения

Код	Значение	Описание	Состояние
1	Pending	Сообщение подготавливается к отправке	Промежуточный
2	Scheduled	Сообщение запланировано и находиться в очереди для отправки	Промежуточный
3	Sent	Сообщение отправлено	Промежуточный
4	OutOfBalance	Недостаточно средств для отправки сообщений	Окончательный
5	InvalidMobile	Неверный формат номера получателя	Окончательный
6	InvalidBody	Количество допустимых символов превышено. Максимальное количество 500 символов для SMS сообщений и 1000 символов для VIBER сообщений	Окончательный
7	InvalidRoute	Данное направление недоступно для отправки сообщений с Вашего аккаунта. Свяжитесь с Вашим менеджером	Окончательный
8	BlockedMobile	Получатель заблокирован. Получатель внес свой номер в список заблокированных номеров (отказался от рассылок).	Окончательный
9	Unknown	Сообщение с указанным идентификатором не найдено	Окончательный
10	InvalidMarketingTime	В системе действуют ограничения. Отправка SMS сообщений от зарегистрированных маркетинговых имен отправителей по направлению Армения возможна только в период с понедельника по пятницу с 10:00 до 20:00 (UTC+4)	Окончательный
20	InvalidImageURL	Неверно указано значение параметра Image. Сообщение не отправлено. (только для VIBER сообщений)	Окончательный
21	ActionNotDefined	Указано значение параметра Caption, но не указано значение параметра Action. Сообщение не отправлено. (только для VIBER сообщений)	Окончательный
22	CaptionNotDefined	Указано значение параметра Action, но не указано значение параметра Caption. Сообщение не отправлено. (только для VIBER сообщений)	Окончательный
23	InvalidActionURL	Неверно указано значение параметра Action. Сообщение не отправлено. (только для VIBER сообщений)	Окончательный
24	InvalidSite	Сайт указанный в параметре Action недоступен. Сообщение не отправлено. (только для VIBER сообщений)	Окончательный
25	NoImageFound	Ссылка указанная в параметре Image должна указывать на изображение. Сообщение не отправлено. (только для VIBER сообщений)	Окончательный
26	CaptionAndActionMustDefined	Для использования параметра Image параметры Caption и Action должны быть определены. Сообщение не отправлено. (только для VIBER сообщений)	Окончательный
100	Delivered	Сообщение доставлено	Окончательный
101	Undeliverable	Сообщение не доставлено	Окончательный
102	Expired	Сообщение отправлено. Статус сообщения неизвестен	Окончательный
103	RejectedByOperator	Невозможно доставить сообщение	Окончательный
104	TimeOut	Ошибка системы. Время ожидания отправки сообщения истекло. Сообщение не отправлено	Окончательный
105	Seen	Сообщение прочтено получателем. Система мониторит данный статус в течение времени, которое указано в параметре ValidityPeriod (см. метод SendViber) (только для VIBER сообщений)	Окончательный
106	NotSeen	Сообщение не прочтено получателем. Система мониторит данный статус в течение времени, которое указано в параметре ValidityPeriod (см. метод SendViber) (только для VIBER сообщений)	Промежуточный
107	NotViberUser	Мобильный номер получателя не зарегистрирован в VIBER. (только для VIBER сообщений)	Окончательный
108	NoSuitableDevice	Номер получателя зарегистрирован в VIBER, но аппарат получателя не поддерживает прием VIBER сообщений (только для VIBER сообщений)	Окончательный

Коды статусов обработки запросов и их значения

Код	Значение	Описание
100	Unknown	Ошибка системы.
101	Success	Успешное завершение запроса.
102	IncorrectSessionID	Неверный формат параметра SessionID или параметр отсутсвует в запросе.
103	SessionExpired	Сессия с таким ID истекла или не существует
104	AccessDenied	Система уже обрабатывает запрос с этим ID сессии. Запрос с указанным ID сессии временно невозможен.
105	IncorrectReferences	Запрос не содержит ни одного уникального ID или формат предоставленных ID некорректен.
106	IncorrectParameter	Запрос составлен неверно. Пожалуйста провертьте корректность тела запроса.
200	IncorrectUserNameOrPassword	Неверное имя пользователя или пароль. Проверьте правильность введенных данных
201	UserLocked	Количество допустимых ошибок при авторизации превышено. Попробуйте снова через 30 минут
202	UserBlocked	Аккаунт заблокирован. Свяжитесь с Вашим менеджером.
300	OutOfBalance	Недостаточно средств для отправки сообщений.
301	CountOverflow	В рамках одного запроса поддерживается отправка/проверка статусов SMS сообщений не более чем 20 000 получателям и отправка/проверка статусов VIBER сообщений не более чем 100 000/20 000 получателям
302	CurrencyNotDefined	Валюта счета неопределенна. Перейдите в раздел “Персональные данные” и укажите валюту
303	SenderNotDefined	Значение парамера Sender отсутствует.
304	MessagesNotDefined	Запрос не содержит ни одного сообщения для отправки.
305	InvalidSenderName	Имя отправителя не зарегистрировано. Свяжитесь с Вашим менеджером.
306	InvalidDateTimeFormat	Значение параметра ScheduledDate некорректно. Формат ScheduledDate "yyyy-MM-dd HH:mm:ss".
307	PastDateTime	Значение параметра ScheduledDate определено в прошедшем времени.
308	InvalidSendWithinHours	Значение параметра SendWithinHours неверно. Возможные значения 1 - 6 (часов).
309	IncorrectValidityPeriod	Значение параметра ValidityPeriod указано неверно. Возможные значения 10 - 1440 (минут). (только для VIBER сообщений)
310	NoValidMessages	Система не нашла ни одного корректного сообщения для отправки или расчета стоимости. Если использовались методы SendSMS/SendViber, пожалуйста проверьте статусы сообщений в разделе Статистика или используйте методы QuerySMSMessages/QueryViberMessages
311	InvalidMarketingTime	В системе действуют ограничения. Отправка SMS сообщений от зарегистрированных маркетинговых имен отправителей по направлению Армения возможна только в период с понедельника по пятницу с 10:00 до 20:00 (UTC+4)
312	ViberChannelNotActivated	Канал для отправки VIBER сообщений не активирован. Свяжитесь с Вашим менеджером

Предупреждение об исключительных правах

Системе MOBIPACE (а также указанному им правообладателю) принадлежат исключительные права на все результаты интеллектуальной деятельности и приравненные к ним средства индивидуализации, используемые при разработке, поддержке и эксплуатации продукта HTTP API 4.0.

К таким результатам могут относиться, программы для ЭВМ, базы данных, изображения, тексты, другие произведения, а также изобретения, полезные модели, товарные знаки, знаки обслуживания, коммерческие обозначения и фирменные наименования.

Эти права охраняются в соответствии с Гражданским кодексом РФ и международным правом.

Вы можете использовать продукт HTTP API 4.0 системы MOBIPACE или его составные части только в рамках полномочий, предоставленных вам Пользовательским соглашением системы или специальным соглашением.

Нарушение требований по защите исключительных прав правообладателя влечет за собой дисциплинарную, гражданско-правовую, административную или уголовную ответственность в соответствии с российским и международным законодательством.

Внесение изменений в HTTP API 4.0 системы MOBIPACE

1. MOBIPACE оставляет за собой право вносить изменения в функционал HTTP API 4.0.

2. ПО Партнера должно без ошибок обрабатывать сообщения сервера с учетом новых ограничений и изменений. Появление новых ограничений не должно вызывать сбои в работе партнерского ПО или ошибки в интерпретации ответов сервера.

3. MOBIPACE обязуется информировать Партнеров о изменениях и публиковать их описание на web-сайте не менее чем за 14 дней до ввода в эксплуатацию. В указанный срок Партнер должен внести необходимые изменения в собственное ПО и проверить корректность его функционирования.

4. Если вносимые изменения приводят к программным сбоям в клиентском ПО Партнера и соответствующая доработка не может быть выполнена до ввода в эксплуатацию обновлений в ПО сервера, ответственное лицо Партнера должно обратиться в службу технической поддержки MOBIPACE.

5. По согласованию с руководством MOBIPACE сроки ввода в эксплуатацию изменений ПО сервера могут быть перенесены.

6. Информация об изменениях, размещаемая на сервере www.mobipace.com , должна регулярно просматриваться Партнером.