API для магазинов

Благодаря API вы сможете интегрировать добавление треков в свою систему управления сайтом, тем самым сэкономив время на добавление треков.

Для зарегистрированных пользователей есть возможность интеграции со следующими системами:

Добавление отслеживания

Пример на php с использованием CURL

$ch = curl_init("http://www.liveinform.ru/api/add/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVrBT",
"phone" => "89001234567",
"tracking" => iconv("windows-1251","utf-8","44003312316849"),
"type" => "1",
"order_id" => iconv("windows-1251","utf-8","№258554"),
"email" => iconv("windows-1251","utf-8","client@gmail.com")
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/add/?api_id=91XOYmKD-s1yXCCip-mbdrFfcN-VTB2VrBT&phone=89001234567&tracking=".urlencode(iconv("windows-1251","utf-8","44003312316849"))."&type=2&order_id=".urlencode(iconv("windows-1251","utf-8","№416"))."&email=".urlencode(iconv("windows-1251","utf-8","client@gmail.com")));
echo $body;

Адрес

http://www.liveinform.ru/api/add/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
phone да Телефон клиента в формате (89001234567 или +79001234567)
tracking да Трек-номер посылки (14-ти значный для "Почты России", либо 13 для EMS)
type да Тип отслеживания. 2 или 1 . За 20 и 10 рублей соответственно.
order_id нет Номер заказа внутри вашего магазина
e-mail нет E-mail клиента
firstname нет Имя клиента
lastname нет Фамилия клиента
tags нет Метки через запятую
additional1 нет Дополнительное поле 1, до 255 символов
additional2 нет Дополнительное поле 2, до 255 символов
additional3 нет Дополнительное поле 3, до 255 символов
test=1 нет Имитирует добавление трека для тестирования ваших программ на правильность обработки ответов сервера. При этом сам трек не добавляется и баланс не расходуется.

Варианты ответа

При успешном добавлении трека сервер ответит:

100
2123

В данном случае: 100 - успешный ответ сервера, 2123 - ID отправления (на следующей строке).

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

201
204

201 - Неправильно введен телефон, 204 - Не хватает денежных средств

Ответ Описание
100 Отслеживание успешно добавлено
200 Неправильный api_id
201 Неправильно введен телефон
202 Неправильно введен трек-номер
203 Не указан тип отслеживания
204 Не хватает денежных средств
205 Отслеживание с таким телефоном клиентом и трек-номер уже отслеживается


 

Получение состояния баланса

$ch = curl_init("http://www.liveinform.ru/api/balance/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVrBT",
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/balance/?api_id=91XOYmKD-s4yXCCip-mbdrFfcN-VTB2VrBT"); 
echo $body;

Адрес

http://www.liveinform.ru/api/balance/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API

Варианты ответа

При успешном добавлении трека сервер ответит:

100
1560

В данном случае: 100 - успешный ответ сервера, 1560 - баланс счета в рублях.

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

200

200 - Неправильно введен api_id

Ответ Описание
100 Успешный ответ сервера
200 Неправильный api_id

Получение состояния баланса звонков

$ch = curl_init("http://www.liveinform.ru/api/callbalance/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVrBT",
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/callbalance/?api_id=91XOYmKD-s4yXCCip-mbdrFfcN-VTB2VrBT"); 
echo $body;

Адрес

http://www.liveinform.ru/api/callbalance/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API

Варианты ответа

При успешном добавлении трека сервер ответит:

100
1560
520

В данном случае: 100 - успешный ответ сервера, 1560 - баланс счета в рублях, 520 - количество доступных звонков.

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

200

200 - Неправильно введен api_id

Ответ Описание
100 Успешный ответ сервера
200 Неправильный api_id

Остановка отслеживания трека

$ch = curl_init("http://www.liveinform.ru/api/stop/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVrBT",
"phone" => "89001234567",
"tracking" => iconv("windows-1251","utf-8","44003312316849"),
"reason" => "1"
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/stop/?api_id=91XOYmKD-s1yXCCip-mbdrFfcN-VTB2VrBT&phone=89001234567&tracking=".urlencode(iconv("windows-1251","utf-8","44003312316849"))."&reason=2"); 
echo $body;

Адрес

http://www.liveinform.ru/api/stop/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
phone да Телефон клиента в формате (89001234567 или +79001234567)
tracking да Трек-номер посылки (14-ти значный для "Почты России", либо 13 для EMS)
reason да Тип отслеживания. 1, 2 или 3 . 1 - Остановка трека, 2 - Остановка и перевод в "Успешно врученные", 3 - Остановка и перевод в "Возвраты"

Варианты ответа

При успешном добавлении трека сервер ответит:

100

В данном случае: 100 - успешный ответ сервера

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

200

200 - Неправильно введен api_id

Ответ Описание
100 Отслеживание успешно добавлено
200 Неправильный api_id
201 Неправильно введен телефон
202 Неправильно введен трек-номер
207 Не указан параметр "reason"
208 Заказ не найден

 

Получение информации об отслеживании

$ch = curl_init("http://www.liveinform.ru/api/getinfo/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVrBT",
"phone" => "89001234567",
"tracking" => iconv("windows-1251","utf-8","44003312316849"),
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/getinfo/?api_id=91XOYmKD-s1yXCCip-mbdrFfcN-VTB2VrBT&phone=89001234567&tracking=".urlencode(iconv("windows-1251","utf-8","44003312316849"))); 
echo $body;

Адрес

http://www.liveinform.ru/api/getinfo/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
phone да Телефон клиента в формате (89001234567 или +79001234567)
tracking да Трек-номер посылки (14-ти значный для "Почты России", либо 13 для EMS)

Варианты ответа

При успешном запросе  сервер ответит:

100
{"status":4,"weight":"0.07","value":"1040","price":"1040","0":{"date":"18.03.2016 10:44","operation":"\u0412\u0440\u0443\u0447\u0435\u043d\u0438\u0435","text":"\u0412\u0440\u0443\u0447\u0435\u043d\u0438\u0435 \u0430\u0434\u0440\u0435\u0441\u0430\u0442\u0443","geo":"","index":""},"1":{"date":"18.03.2016 10:44","operation":"\u0412\u043e\u0437\u0432\u0440\u0430\u0442","text":"\u0418\u0441\u0442\u0435\u043a \u0441\u0440\u043e\u043a \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f","geo":"","index":""},"2":{"date":"17.03.2016 19:54","operation":"\u0412\u043e\u0437\u0432\u0440\u0430\u0442","text":"\u0418\u0441\u0442\u0435\u043a \u0441\u0440\u043e\u043a \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f","geo":"","index":""},"3":{"date":"17.03.2016 19:54","operation":"\u0412\u0440\u0443\u0447\u0435\u043d\u0438\u0435","text":"\u0412\u0440\u0443\u0447\u0435\u043d\u0438\u0435 \u0430\u0434\u0440\u0435\u0441\u0430\u0442\u0443","geo":"","index":""},"4":{"date":"17.03.2016 15:46","operation":"\u0412\u043e\u0437\u0432\u0440\u0430\u0442","text":"\u0418\u0441\u0442\u0435\u043a \u0441\u0440\u043e\u043a \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f","geo":"","index":""},"5":{"date":"04.03.2016 15:32","operation":"\u0412\u0440\u0443\u0447\u0435\u043d\u0438\u0435","text":"\u0412\u0440\u0443\u0447\u0435\u043d\u0438\u0435 \u0430\u0434\u0440\u0435\u0441\u0430\u0442\u0443","geo":"","index":""},"6":{"date":"04.03.2016 08:45","operation":"\u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430","text":"\u041f\u0440\u0438\u0431\u044b\u043b\u043e \u0432 \u043c\u0435\u0441\u0442\u043e \u0432\u0440\u0443\u0447\u0435\u043d\u0438\u044f","geo":"\u041a\u0440\u0430\u0441\u043d\u043e\u0434\u0430\u0440 15","index":"350015"},"7":{"date":"04.03.2016 07:21","operation":"\u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430","text":"\u041f\u043e\u043a\u0438\u043d\u0443\u043b\u043e \u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043e\u0447\u043d\u044b\u0439 \u0446\u0435\u043d\u0442\u0440","geo":"\u041a\u0440\u0430\u0441\u043d\u043e\u0434\u0430\u0440 \u041f\u043e\u0447\u0442\u0430\u043c\u0442","index":"350999"},"8":{"date":"03.03.2016 05:22","operation":"\u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430","text":"\u041f\u043e\u043a\u0438\u043d\u0443\u043b\u043e \u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043e\u0447\u043d\u044b\u0439 \u0446\u0435\u043d\u0442\u0440","geo":"\u041a\u0440\u0430\u0441\u043d\u043e\u0434\u0430\u0440 \u041c\u0421\u0426","index":"350960"},"9":{"date":"29.02.2016 06:50","operation":"\u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430","text":"\u041f\u043e\u043a\u0438\u043d\u0443\u043b\u043e \u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043e\u0447\u043d\u044b\u0439 \u0446\u0435\u043d\u0442\u0440","geo":"\u0421\u0430\u043c\u0430\u0440\u0430 \u041c\u0421\u0426","index":"443960"},"10":{"date":"29.02.2016 00:53","operation":"\u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430","text":"\u041f\u0440\u0438\u0431\u044b\u043b\u043e \u0432 \u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043e\u0447\u043d\u044b\u0439 \u0446\u0435\u043d\u0442\u0440","geo":"\u0421\u0430\u043c\u0430\u0440\u0430 \u041c\u0421\u0426","index":"443960"},"11":{"date":"28.02.2016 14:22","operation":"\u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430","text":"\u041f\u043e\u043a\u0438\u043d\u0443\u043b\u043e \u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043e\u0447\u043d\u044b\u0439 \u0446\u0435\u043d\u0442\u0440","geo":"\u041e\u0440\u0435\u043d\u0431\u0443\u0440\u0433 \u041c\u0421\u0426","index":"460960"},"12":{"date":"28.02.2016 14:11","operation":"\u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430","text":"\u041f\u0440\u0438\u0431\u044b\u043b\u043e \u0432 \u0441\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u043e\u0447\u043d\u044b\u0439 \u0446\u0435\u043d\u0442\u0440","geo":"\u041e\u0440\u0435\u043d\u0431\u0443\u0440\u0433 \u041c\u0421\u0426","index":"460960"},"13":{"date":"27.02.2016 12:08","operation":"\u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430","text":"\u041f\u043e\u043a\u0438\u043d\u0443\u043b\u043e \u043c\u0435\u0441\u0442\u043e \u043f\u0440\u0438\u0451\u043c\u0430","geo":"\u041e\u0440\u0435\u043d\u0431\u0443\u0440\u0433 3","index":"460003"},"14":{"date":"27.02.2016 12:08","operation":"\u041f\u0440\u0438\u0435\u043c","text":"\u041f\u0430\u0440\u0442\u0438\u043e\u043d\u043d\u044b\u0439","geo":"\u041e\u0440\u0435\u043d\u0431\u0443\u0440\u0433 3","index":"460003"}}

В данном случае: 100 - успешный ответ сервера, на второй строке публикуется json-массив данных, содержащий следующие данные: status - Статус заказа (0 - В пути, 1 - На почте, 2 - Вручен, 3 - Возврат)
weight - вес посылки (кг)
value - объявленная ценность (руб.)
price - наложенный платеж (руб.)
Далее расположен массив с данными для каждого из статусов (date, operation, text, geo, index).

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

200

200 - Неправильно введен api_id

Ответ Описание
100 Отслеживание найдено
200 Неправильный api_id
201 Неправильно введен телефон
202 Неправильно введен трек-номер
208 Заказ не найден
210 Информация по треку пока не поступало

Получение информации о наложенном платеже

$ch = curl_init("http://www.liveinform.ru/api/np/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVrBT",
"phone" => "89001234567",
"tracking" => iconv("windows-1251","utf-8","44003312316849"),
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/np/?api_id=91XOYmKD-s1yXCCip-mbdrFfcN-VTB2VrBT&phone=89001234567&tracking=".urlencode(iconv("windows-1251","utf-8","44003312316849"))); 
echo $body;

Адрес

http://www.liveinform.ru/api/np/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
phone да Телефон клиента в формате (89001234567 или +79001234567)
tracking да Трек-номер посылки (14-ти значный для "Почты России", либо 13 для EMS)

Варианты ответа

При успешном запросе  сервер ответит:

100
[{"number":"19721","event":"\u041f\u0440\u0438\u0451\u043c","date":"1456141839","indexFrom":"143007","indexTo":"344000","summa":"1580"},{"number":"19721","event":"\u041e\u043f\u043b\u0430\u0442\u0430","date":"1456486213","indexFrom":"344000","indexTo":"344000","summa":"1580"}]

В данном случае: 100 - успешный ответ сервера, на второй строке публикуется json-массив данных. Содержащий следующие данные (number, event, date, indexFrom, indexTo, summa) для каждого из статусов.

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

200

200 - Неправильно введен api_id

Ответ Описание
100 Отслеживание найдено
200 Неправильный api_id
201 Неправильно введен телефон
202 Неправильно введен трек-номер
208 Заказ не найден
210 Информация по треку пока не поступало

Получение информации о СМС

$ch = curl_init("http://www.liveinform.ru/api/getsms/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVr1T",
"phone" => "89001234567",
"tracking" => iconv("windows-1251","utf-8","44003312316849"),
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

или:

$ch = curl_init("http://www.liveinform.ru/api/getsms/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVr1T",
"order_id" => "1234",
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/getsms/?api_id=91XOYmKD-s1yXCCip-mbdrFfcN-VTB2VrBT&phone=89001234567&tracking=".urlencode(iconv("windows-1251","utf-8","44003312316849"))); 
echo $body;

Адрес

http://www.liveinform.ru/api/getsms/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
phone да Телефон клиента в формате (89001234567 или +79001234567)
tracking да Трек-номер посылки (14-ти значный для "Почты России", либо 13 для EMS)

или 

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
order_id да ID-заказа внутри нашего сервиса

Варианты ответа

При успешном запросе  сервер ответит:

100
[{"sms_id":"284442","date":"1411464241","text":" \u0417\u0430\u043a\u0430\u0437 \u043f\u0440\u0438\u0431\u044b\u043b \u0432 \u0432\u0430\u0448\u0435 \u043f\u043e\u0447\u0442\u043e\u0432\u043e\u0435 \u043e\u0442\u0434\u0435\u043b\u0435\u043d\u0438\u0435 682738. \u0422\u0440\u0435\u043a-\u043d\u043e\u043c\u0435\u0440: 46000371031513 \u0421\u0443\u043c\u043c\u0430: 880 \u0440\u0443\u0431.","status_code":"103","status_text":"\u0414\u043e\u0441\u0442\u0430\u0432\u043b\u0435\u043d\u043e"},{"sms_id":"284407","date":"1411464221","text":"gdfg dfgdfd g","status_code":"103","status_text":"\u0414\u043e\u0441\u0442\u0430\u0432\u043b\u0435\u043d\u043e"}]

В данном случае: 100 - успешный ответ сервера, на второй строке публикуется json-массив данных. Содержащий следующие данные (sms_id - id смс, date - дата, text - текст, status_code - статус в кодовом формате, status_text - статус сообщения в текстовом формате) для каждого из сообщений.

Таблица status_code:

Код Значение
100 В очереди
101 Передача сообщения оператору
102 В пути
103 Доставлено
104 Не может быть доставлено: время жизни истекло
105 Не может быть доставлено: удалено оператором
106 Не может быть доставлено: сбой в телефоне
107 Не может быть доставлено: неизвестная причина
108 Не может быть доставлено: отклонено

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

200

200 - Неправильно введен api_id

Ответ Описание
100 Отслеживание найдено
200 Неправильный api_id
201 Неправильно введен телефон
202 Неправильно введен трек-номер
208 Заказ не найден
210 Информация по треку пока не поступало

Получение информации о совершенных звонках

$ch = curl_init("http://www.liveinform.ru/api/getcalls/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVr1T",
"phone" => "89001234567",
"tracking" => iconv("windows-1251","utf-8","44003312316849"),
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

или:

$ch = curl_init("http://www.liveinform.ru/api/getcalls/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVr1T",
"order_id" => "1234",
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/getcalls/?api_id=91XOYmKD-s1yXCCip-mbdrFfcN-VTB2VrBT&phone=89001234567&tracking=".urlencode(iconv("windows-1251","utf-8","44003312316849"))); 
echo $body;

Адрес

http://www.liveinform.ru/api/getcalls/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
phone да Телефон клиента в формате (89001234567 или +79001234567)
tracking да Трек-номер посылки (14-ти значный для "Почты России", либо 13 для EMS)

или 

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
order_id да ID-заказа внутри нашего сервиса

Варианты ответа

Таблица status_code:

Код Значение
100 Принят к исполнению
101 Звонок исполняется
102 Абонент занят
103 Соединение не установлено
104 Звонок исполнен полностью
105 Звонок исполнен, прерван абонентом
106 Абонент не ответил
107 Внутренняя ошибка сервера
108 Исходящий номер заблокирован
109 Отменен

При успешном запросе  сервер ответит:

100
[{"call_id":"141","date":"1402388153","status":"\u0417\u0432\u043e\u043d\u043e\u043a \u0438\u0441\u043f\u043e\u043b\u043d\u0435\u043d, \u043f\u0440\u0435\u0440\u0432\u0430\u043d \u0430\u0431\u043e\u043d\u0435\u043d\u0442\u043e\u043c", "status_code":"105","duration":"8"}]

В данном случае: 100 - успешный ответ сервера, на второй строке публикуется json-массив данных. Содержащий следующие данные (call_id - id звонка, date - дата, text - текст, status - статус, duration - длительность звонка в секундах) для каждого из звонка.

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

200

200 - Неправильно введен api_id

Ответ Описание
100 Отслеживание найдено
200 Неправильный api_id
201 Неправильно введен телефон
202 Неправильно введен трек-номер
208 Заказ не найден
210 Информация по треку пока не поступало
 

Получение информации об отправленных E-mail

$ch = curl_init("http://www.liveinform.ru/api/getemails/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVr1T",
"phone" => "89001234567",
"tracking" => iconv("windows-1251","utf-8","44003312316849"),
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

или:

$ch = curl_init("http://www.liveinform.ru/api/getemails/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVr1T",
"order_id" => "1234",
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/getemails/?api_id=91XOYmKD-s1yXCCip-mbdrFfcN-VTB2VrBT&phone=89001234567&tracking=".urlencode(iconv("windows-1251","utf-8","44003312316849"))); 
echo $body;

Адрес

http://www.liveinform.ru/api/getemails/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
phone да Телефон клиента в формате (89001234567 или +79001234567)
tracking да Трек-номер посылки (14-ти значный для "Почты России", либо 13 для EMS)

или 

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
order_id да ID-заказа внутри нашего сервиса

Варианты ответа

При успешном запросе  сервер ответит:

100
[{"email_id":"120163","date":"1433531881","to":"vyacheslav.pavlov@gmail.com","from":"support@liveinform.ru","subject":"\u0412\u0430\u0448 \u0437\u0430\u043a\u0430\u0437 \u043f\u0440\u0438\u0431\u044b\u043b \u0432 \u043c\u0435\u0441\u0442\u043e \u0432\u0440\u0443\u0447\u0435\u043d\u0438\u044f","status":"\u041e\u0442\u043a\u0440\u044b\u0442\u043e","status_date":"1433567022","url":""},{"email_id":"119728","date":"1433499508","to":"vyacheslav.pavlov@gmail.com","from":"support@liveinform.ru","subject":"\u0412\u0430\u0448 \u0437\u0430\u043a\u0430\u0437 3213 \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u0435\u043d!","status":"\u041e\u0442\u043a\u0440\u044b\u0442\u043e","status_date":"1433499624","url":""}]

В данном случае: 100 - успешный ответ сервера, на второй строке публикуется json-массив данных. Содержащий следующие данные (email_id - id письма, date - дата отправки, to - кому, from - от кого, subject - тема письма, status - статус (доставлено, открыто, в спаме, клик и т.п.), status_date - дата последнего события, url - переход по ссылке) для каждого из писем.

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

200

200 - Неправильно введен api_id

Ответ Описание
100 Отслеживание найдено
200 Неправильный api_id
201 Неправильно введен телефон
202 Неправильно введен трек-номер
208 Заказ не найден

Callback-оповещения о новых статусах заказа

В разделе callback вы можете указать адрес скрипта, на который будут отправляться оповещения от нашего сервиса. Указанный скрипт будет вызываться нашим сервером после каждого получения нового статуса отправления.

Переменная $_POST['data'] содержит в себе json-массив с полной информацией о заказе: параметры заказа, трекинг, СМС, звонки и E-mail.

Ваш скрипт должен вернуть HTTP-статус 200, в противном случае наш сервер будет пытаться отправить информацию повторно каждые 15 минут (максимальное количество попыток - 10).

			 
{  
   "order_id":"1389374", // ID заказа в системе LiveInform 
   "phone":"89603560390", // Телефон
   "tracking":"15000098940051", // Трек-номер
   "email":"support@liveinform.ru", // E-mail
   "lastname":"Иванов", // Фамилия
   "firstname":"Александр", // Имя
   "type":"1", // Тип отслеживания (1 или 2)
   "account_order_id":"123", // Номер заказа
   "index":"410062", // Индекс место вручения
   "address":"САРАТОВ, САРАТОВСКАЯ ОБЛАСТЬ", // Регион
   "comment":"Комментарий к заказу", // Комментарий к заказу
   "status":"0", // Статус отслеживания (0 - индексируется, 1 - не индексируется)
   "track_status":"1", // Статус заказа (0 - в пути, 1 - в месте вручения, 2 - вручен, 3 - возврат,  4 - остановлен)
   "weight":"0.42", // Вес отправления, кг
   "value":"1853", // Объявленная ценность, руб.
   "price":"1853", // Наложенный платеж, руб.
   "additional1":"Допполе 1", // Дополнительное поле 1
   "additional2":"Допполе 2", // Дополнительное поле 2
   "additional3":"Допполе 3", // Дополнительное поле 3
   "tags":"Метка 1, Метка 2", // Метки
   "tracking": [ // Данные о трекинге
      {
         "date": "1471866678",
         "operation": "Обработка",
         "text": "Прибыло в место вручения",
         "geo": "Нижнекамск 14",
         "index": "423584"
      },
      {
         "date": "1471841747",
         "operation": "Обработка",
         "text": "Покинуло сортировочный центр",
         "geo": "Нижнекамск Почтамт",
         "index": "423599"
      },
      {
         "date": "1471729176",
         "operation": "Обработка",
         "text": "Покинуло сортировочный центр",
         "geo": "Казань МСЦ",
         "index": "420960"
      },
      {
         "date": "1471676759",
         "operation": "Обработка",
         "text": "Прибыло в сортировочный центр",
         "geo": "Казань МСЦ",
         "index": "420960"
      },
      {
         "date": "1471417068",
         "operation": "Обработка",
         "text": "Покинуло сортировочный центр",
         "geo": "Ярославль МСЦ",
         "index": "150960"
      }
   ],
   "sms": [ // Данные об отправленных СМС
      {
         "sms_id": "5430866",
         "date": "1472551200",
         "text": "Алекснадр Иванов, ваш заказ 123 отправлен. Трек-номер: 15000098940051",
         "status_code": "100",
         "status_text": "В очереди"
      },
      {
         "sms_id": "5430872",
         "date": "1472551200",
         "text": "Алекснадр Иванов, ваш заказ 123 прибыл в место вручения 423584. Сумма к оплате 1853 руб.",
         "status_code": "",
         "status_text": ""
      } 
   ],
   "calls": [ // Данные о совершенных звонках
      {
         "call_id": "610014",
         "date": "1472549813",
         "text": "Здравствуйте, Алекснадр. Ваш заказ 123 в интернет-магазине shop.ru отправлен",
         "status": "Звонок исполнен полностью",
         "duration": "9",
      }
   ],
   "emails": [ // Данные об отправленных E-mail
      {
         "email_id": "610014",
         "date": "1472549813",
         "to": "support@liveinform.ru",
         "from": "support@shop.ru",
         "subject": "Ваш заказ отправлен",
         "status": "Отправка",
         "status_date": "0",
         "url": ""
      }
   ]
   
}
			

Dashboard - получение общей информации по статусам

Пример на php с использованием CURL

$ch = curl_init("http://www.liveinform.ru/api/dashboard/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVrBT",
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/dashboard/?api_id=91XOYmKD-s1yXCCip-mbdrFfcN-VTB2VrBT")));
echo $body;

Адрес

http://www.liveinform.ru/api/dashboard/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
period нет Период: неделя (week), месяц (month), за все вермя (all) или выбранный период (period). При выборе периода обязательно указать переменные start и end
start нет Выбор произвольного периода. Стартовая дата в формате 05.11.2014
end нет Выбор произвольного периода. Конечная дата в формате 05.11.2015

Варианты ответа

При успешном запросе сервер ответит:

100
{"ontheway":{"sum":3,"percent":"1.5%"},"ready":{"sum":0,"percent":"0%"},"welldone":{"sum":172,"percent":"84.7%"},"vozvrat":{"sum":28,"percent":"13.8%"},"all":{"summa":203,"percent":"100%"}}

В данном случае: 100 - успешный ответ сервера, на второй строчке в формате json: ontheway - в пути, ready - в месте вручения, welldone - врученные, return - возвраты, all - всего. Переменная summa отражает количество заказов по данному статусу, а percent процентное соотношение к общему числу заказов за выбранный период.

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

200

200 - Неправильно введен api_id

Ответ Описание
200 Неправильный api_id


 

Черный список

Проверка данных (телефон или E-mail) клиента на наличие невыкупленных заказов с наложенном платежом.

$ch = curl_init("http://www.liveinform.ru/api/blacklist/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVrBT",

"phone" => "89001234567",
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/blacklist/?api_id=91XOYmKD-s4yXCCip-mbdrFfcN-VTB2VrBT&phone=89001234567"); 
echo $body;

Адрес

http://www.liveinform.ru/api/blacklist/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
phone да Телефон

или

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
email да E-mail клиента

Варианты ответа

Если данные найдены в нашей базе:

100
1

В данном случае: 100 - успешный ответ сервера, 1 - найдено совпадение.

Если данные отсутствуют в нашей базе:

100
0

100 - успешный ответ сервера, 0 - совпадений нет.

Если в ходе добавления возникла какая-либо ошибка сервер ответит следующий образом:

200

200 - Неправильно введен api_id

Ответ Описание
100 Успешный ответ сервера
200 Неправильный api_id
201 Неправильно введен телефон
206 Неправильно введен E-mail

Отправка СМС

$ch = curl_init("http://www.liveinform.ru/api/sendsms/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVrBT",
"phone" => "89001234567",
"text" => iconv("windows-1251","utf-8","Текст сообщения"),
"time" => "1481338675"
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/sendsms/?api_id=91XOYmKD-s1yXCCip-mbdrFfcN-VTB2VrBT&phone=89001234567&text=".urlencode(iconv("windows-1251","utf-8","Текст сообщения"))."&time=1481338675"); 
echo $body;

Адрес

http://www.liveinform.ru/api/sendsms/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
phone да Телефон клиента в формате (89001234567 или +79001234567)
text да Текст сообщения
time нет Время отправки в формате UNIX TIMESTAMP. Если переменная не указана, отправка будет осуществлена согласно указанному времени для рассылок.
translit=1 нет Транслитерация сообщения

Вместо переменной phone можно использовать order_id:

Параметр Обязательный Описание
order_id да ID-заказа внутри нашего сервиса

Варианты ответа

При успешном добавлении СМС сервер ответит:

100

В данном случае: 100 - успешный ответ сервера

Если в ходе операции возникла какая-либо ошибка, сервер выведет номера ошибок:

200

200 - Неправильно введен api_id

Ответ Описание
100 Успешный ответ
200 Неправильный api_id
201 Неправильно введен телефон
204 Не хватает денежных средств
208 Заказ не найден
209 Не указан текст

Совершение звонка

$ch = curl_init("http://www.liveinform.ru/api/sendcall/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(

"api_id" => "91XOYmKP-s2yXCCip-mbSrFfcN-VTBDVrBT",
"phone" => "89001234567",
"text" => iconv("windows-1251","utf-8","Текст звонка"),
"time" => "1481338675"
));
$body = curl_exec($ch);
curl_close($ch);
echo $body;

Пример на php без CURL

$body = file_get_contents("http://www.liveinform.ru/api/sendcall/?api_id=91XOYmKD-s1yXCCip-mbdrFfcN-VTB2VrBT&phone=89001234567&text=".urlencode(iconv("windows-1251","utf-8","Текст звонка"))."&time=1481338675"); 
echo $body;

Адрес

http://www.liveinform.ru/api/sendcall/

Методы

GET, POST

Параметры метода

Параметр Обязательный Описание
api_id да Уникальный идентификатор API
phone да Телефон клиента в формате (89001234567 или +79001234567)
text да Текст звонка
time нет Время отправки в формате UNIX TIMESTAMP. Если переменная не указана, звонок будет осуществлен согласно указанному времени в настройках.

Вместо переменной phone можно использовать order_id:

Параметр Обязательный Описание
order_id да ID-заказа внутри нашего сервиса

Варианты ответа

При успешном добавлении звонка сервер ответит:

100

В данном случае: 100 - успешный ответ сервера

Если в ходе операции возникла какая-либо ошибка, сервер выведет номера ошибок:

200
201

200 - Неправильно введен api_id

201 - Неправильно введен телефон

Ответ Описание
100 Успешный ответ
200 Неправильный api_id
201 Неправильно введен телефон
204 Не хватает денежных средств
208 Заказ не найден
209 Не указан текст
209 Не указан текст
211 Отствует исходящий номер для звонков
более 1 миллиона клиентов магазинов
уже проинформированы