Что такое 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>
|
|
|
Новое в 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-функций
|
|
|
