Грузы и транспорт | Автомаркет | API
Главная  |  Справочник
Новое в API / Справочник API / PHP-коннектор

Основы работы со справочниками - функции для работы со справочниками

Функция baseValuta


Функция позволяет получить список типов валюты доступных в системе lardi-trans.com.
function baseValuta($sig)
{
        $data='method=base.valuta&sig='.$sig; //формируем строку запроса
        $resp = $this->doRequest($data);  //метод doRequest передает запрос на сервер
        if (strpos($resp, "<error>")!==false) {
                //если произошла ошибка возвращаем её
                throw new Exception("base.valuta error!<br/>$resp"); 
        }
        else
        {
        	//преобразовываем ответ cервера в SimpleXML
                $smplXml = new SimpleXmlElement($resp, LIBXML_NOCDATA);
                return $smplXml; //возвращаем ответ в формате SimpleXML
        }
}
Функция имеет один обязательный параметр $sig - уникальный номер выданный при авторизации методом auth.
После запроса, если не произошло никакой ошибки, ответ сервера будет преобразован в формат SimpleXML и возвращен в ответе функции.

Пример использования функции baseValuta

  1. <?php
  2. include_once('lardiapi.php'); //подключаем библиотеку
  3. $login = "ваш логин"; //логин в системе lardi-trans.com
  4. $pass = "xxxxxxxxxxxxxxxxxxxxxxxxx"; //md5 сумма пароля
  5.  
  6. try
  7. {
  8. $client = new CLardiAPIClient(); //создаем объект класса CLardiAPIClient
  9. $authXML = $client->auth($login, $pass); //вызываем функцию auth
  10. echo "<h1>base.valuta</h1>";
  11. $basevalutaXML = $client->baseValuta($authXML->sig); //вызываем функцию baseValuta
  12. //выводим результат
  13. foreach ($basevalutaXML->item as $item) {
  14. echo "<strong>Item id</strong>:", $item->id, "<br/>";
  15. echo "<strong>Item name</strong>:", $item->name, "<br/>";
  16. }
  17. }
  18. catch(Exception $e)
  19. {
  20. //если произошла ошибка выводим ее
  21. echo "<font color=\"red\">", $e->getMessage(), "</font>";
  22. }
  23. ?>
Во второй строчке подключается библиотека для работы с API сервером, в строках 3-4 задаются переменные $login и $pass, далее идет блок try/catch (строки 6-22), внутри которого в строке 8 создается объект класса CLardiAPIClient и сохраняется в переменную $client. Перед тем как вызвать функцию baseValuta необходимо получить уникальный номер выданный при авторизации методом auth, который вызывается в строке 9 с параметрами $login и $pass, и результат функции в формате SimpleXML, если не произошло никакой ошибки, сохраняется в переменную $authXML. Потом в строке 10 выводится заголовок и далее в 11 строке вызывается функция baseValuta с параметром sig из переменной $authXML. Далее в сроках 13-16 выводится результат функции. Чтобы узнать какие параметры доступны, нужно посмотреть справочник API, находящийся по адресу http://api.lardi-trans.com/reference/. Если в результате вызова функции произошла ошибка, то выполнение перейдет в блок catch (строки 18-22), в котором выводится на экран описание ошибки.

В результате на экран будет выведено:

base.valuta

Item id: 1
Item name: грн
Item id: 4
Item name: руб
Item id: 2
Item name: $
...

Функция baseCountry


Функция позволяет получить список стран и областей доступных в системе lardi-trans.com.
function baseCountry($sig)
{
        $data='method=base.country&sig='.$sig; //формируем строку запроса
        $resp = $this->doRequest($data); //метод doRequest передает запрос на сервер
        if (strpos($resp, "<error>")!==false) {
                //если произошла ошибка возвращаем её
                throw new Exception("base.country error!<br/>$resp"); 
        }
        else
        {
                //преобразовываем ответ cервера в SimpleXML
                $smplXml = new SimpleXmlElement($resp, LIBXML_NOCDATA);
                return $smplXml; //возвращаем ответ в формате SimpleXML
        }
}
Функция имеет один обязательный параметр $sig - уникальный номер выданный при авторизации методом auth.
После запроса, если не произошло никакой ошибки, ответ сервера будет преобразован в формат SimpleXML и возвращен в ответе функции.

Пример использования функции baseCountry

  1. <?php
  2. include_once('lardiapi.php'); //подключаем библиотеку
  3. $login = "ваш логин"; //логин в системе lardi-trans.com
  4. $pass = "xxxxxxxxxxxxxxxxxxxxxxxxxx"; //md5 сумма пароля
  5.  
  6. echo "<style type=\"text/css\">
  7. table, td, th {border: 1px solid black; border-collapse: collapse;}
  8. table th {background-color: gold;}</style>";
  9.  
  10. try
  11. {
  12. $client = new CLardiAPIClient(); //создаем объект класса CLardiAPIClient
  13. $authXML = $client->auth($login, $pass); //вызываем функцию auth
  14. echo "<h1>base.country</h1>";
  15. $basecountryXML = $client->baseCountry($authXML->sig); //вызываем функцию baseCountry
  16. foreach ($basecountryXML->item as $item) {
  17. echo "<strong>Item id</strong>: ", $item->id, "<br/>";
  18. echo "<strong>Item sign</strong>: ", $item->sign, "<br/>";
  19. echo "<strong>Item sign2</strong>: ", $item->sign2, "<br/>";
  20. echo "<table><tr><th>id</th><th>name</th></tr>";
  21. foreach ($item->areas->area as $area) {
  22. echo "<tr><td>", $area->id, "</td>";
  23. echo "<td>", $area->name, "</td></tr>";
  24. }
  25. echo "</table>";
  26. }
  27. }
  28. catch(Exception $e)
  29. {
  30. //если произошла ошибка выводим ее
  31. echo "<font color=\"red\">", $e->getMessage(), "</font>";
  32. }
  33. ?>
Во второй строчке подключается библиотека для работы с API сервером, в строках 3-4 задаются переменные $login и $pass, далее идет блок try/catch (строки 10-32), внутри которого в строке 12 создается объект класса CLardiAPIClient и сохраняется в переменную $client. Перед тем как вызвать функцию baseCountry необходимо получить уникальный номер выданный при авторизации методом auth, который вызывается в строке 13 с параметрами $login и $pass, и результат функции в формате SimpleXML, если не произошло никакой ошибки, сохраняется в переменную $authXML. Потом в строке 14 выводится заголовок и далее в 15 строке вызывается функция baseValuta с параметром sig из переменной $authXML.
Далее в сроках 16-26 выводится результат функции. Чтобы узнать какие параметры доступны, нужно посмотреть справочник API, находящийся по адресу http://api.lardi-trans.com/reference/. Если в результате вызова функции произошла ошибка, то выполнение перейдет в блок catch (строки 28-32), в котором выводится на экран описание ошибки.

В результате на экран будет выведено:

base.country

Item id: 1
Item sign: UA
Item sign2: UA
idname
... ...
15 Винницкая обл.
16 Волынская обл.
17 Днепроп. обл.
... ...
Item id: 2
Item sign: RU
Item sign2: RU
idname
40 Агинский Бурят. окр.
41 Адыгея Р.
42 Алтай Р.
... ...
...
Item id: 49
Item sign: CZ
Item sign2: CZ
idname
...
© Lardi LTD, 1996-2020 API support