API

Главная

Внимание!
Пользователи, которые пользуются старой версией API, обращаем Ваше внимание, что Вам необходимо перейти на новую версию API v. 2.
Старое API будет доступно до 31.08.2020.

Что такое API? Общие принципы работы.

API - это сокращение от Application Programming Interface (интерфейс прикладного программирования) — набор готовых классов, функций, структур и констант, предоставляемых приложением (библиотекой, сервисом) для использования во внешних программных продуктах.

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

Рассчитать расстояния
Загрузить справочники (страны, области)
Управлять своими заявками
Запрашивать информацию о других фирмах

и прочее

Для использования данных функций необходимо:

1. Сформировать HTTP запрос, который включает в себя: адрес сервера, параметр “?method” с указанием необходимого действия и переменные для конкретного действия (если такие имеются).

2. Отослать сформированный запрос на сервер (по указанному адресу) через метод GET/POST:

http://api.lardi-trans.com/api/?method=test&test_text=Слово

3. В ответ получить результат выполнения команды сервером в виде XML:

<?xml version="1.0" encoding="utf-8"?>
	<response>
	  <testfield>test value</testfield>
	  <servertime>2009-08-27 10:49:43</servertime>
	  <version>0.1.1</version>
	  <test_text>Слово</test_text>
	</response>

13.11.2012

Добавлены новые методы:
my.gruztrans.change.contact - изменениe контакта заявок
my.gruztrans.change.date - изменениe даты заявок

09.10.2012

Добавлены новые методы.
Появилась возможность работать с сообщениями через API.

04.01.2011

В методе users.firm.info появилось поле trade_mark - отображающее торговую марку фирмы.

17.12.2010

Добавлен метод установки статуса пользователя user.set.status.
В методе users.firm.info появилось поле user_status - отображающее текущий статус пользователя.

15.12.2010

Исправлен метод users.firm.info. Теперь профиль фирмы отображается верно.

10.11.2010

Исправлен метод users.firm.info. Теперь контактная информация подчиненных контактов фирмы отображается верно.

21.07.2010

Добавлен новый метод test.sig, принимающий в качестве параметра sig-идентификатор, выданный методом auth. Позволяет проверить действительность идентификатора. Полезно вызывать непосредственно перед вызовом каких-либо методов api после авторизации.

9.06.2010

Добавлены методы редактирования грузов и транспорта - my.gruz.edit и my.trans.edit.
При возникновении проблем с использованием api можно писать на api@lardi-trans.com.

8.06.2010

ВНИМАНИЕ! В методе distance.calc (расчет расстояния) для разделения городов используется вертикальная черта, вместо запятой.

31.05.2010

Добавлены новые методы.
Теперь можно получить список грузов и транспорта в сокращенном виде. В ответе будет присутствовать только id заявки, страны и поле add_info. Для корзины в сокращенном виде тоже создан метод.
Добавлен метод получения информации об одной заявке по ее id.

26.05.2010

Добавлено новое поле в грузы/транспорт - add_info.
Поле доступно только через API и только владельцу груза/транспорта.
В этом поле Вы можете хранить номер заявки в Вашей базе данных или любые необходимые Вам данные.
Максимальный размер - 255 байт

27.04.2010

Удаление в корзину, извлечение из корзины и повтор заявок теперь осуществляется отдельными методами для грузов и для транспорта

26.04.2010

XML-ответ на получение списка грузов и транспорта содержит новые поля. См. справочник API

25.04.2010

Переработан сервер обработки api-функций

API support