TBM JSON/XML

Материал из Wiki
Перейти к навигации Перейти к поиску

Ссылка на описание сервисов находится - http://www.tbm.ru/tbm-services/services/application.wadl

На данный момент передача данных в формате JSON/XML - осуществляется только каталога.

Описание и работы сервисов в формате JSON/XML аналогичная как и для работы по протоколу SOAP.

Ответы от сервиса могут приходить в двух форматах XML или JSON. Для этого в header Клиент должен передать accept = application/xml или application/json. Для авторизации используется BASIC – авторизация.

Примеры web сервисов

Метод GET ArrayOfWebCatTree catListTree(long n_skl,int from, int size)- вернуть структуру каталога для указанного склада. По умолчанию n_skl не передается. В этом случае возвращается каталог страны пользователя.

Передаваемые параметры: n_skl – склад from - позиция списка size - размер списка.

Пример вызова метода. http://www.tbm.ru/tbm-services/services/katalog/catListTreeRest?from=1&size=10

Возвращаемый сообщение в формате XML

<arrayOfWebCatTree xmlns="http://www.tbm.ru/">

  <elements>
     <kod>291857</kod>
     <modifydate>2011-08-26T08:52:05+04:00</modifydate>
     <NSkl>6000</NSkl>
     <name>1 компонентные - водостойкость D4</name>
     <nodeDescKod>1409</nodeDescKod>
     <nodelevel>4</nodelevel>
     <parentKod>291853</parentKod>
  </elements>
  <elements>
     <kod>291865</kod>
     <modifydate>2011-08-26T08:52:05+04:00</modifydate>
     <NSkl>6000</NSkl>
     <name>1 компонентные - водостойкость D4</name>
     <nodeDescKod>1409</nodeDescKod>
     <nodelevel>4</nodelevel>
     <parentKod>291862</parentKod>
  </elements>
  <elements>
     <kod>291886</kod>
     <modifydate>2011-08-26T08:52:05+04:00</modifydate>
     <NSkl>6000</NSkl>
     <name>1 компонентные клеи</name>
     <nodeDescKod>2166</nodeDescKod>
     <nodelevel>4</nodelevel>
     <parentKod>291884</parentKod>
  </elements>

</arrayOfWebCatTree>

Возвращаемое значение в формате JSON

{"elements": [

     {
     "name": "1 компонентные - водостойкость D4",
     "kod": 291857,
     "nskl": 6000,
     "nodeDescKod": 1409,
     "modifydate": 1314334325000,
     "parentKod": 291853,
     "nodelevel": 4,
     "nodecomment": null
  },
     {
     "name": "1 компонентные - водостойкость D4",
     "kod": 291865,
     "nskl": 6000,
     "nodeDescKod": 1409,
     "modifydate": 1314334325000,
     "parentKod": 291862,
     "nodelevel": 4,
     "nodecomment": null
  },
     {
     "name": "1 компонентные клеи",
     "kod": 291886,
     "nskl": 6000,
     "nodeDescKod": 2166,
     "modifydate": 1314334325000,
     "parentKod": 291884,
     "nodelevel": 4,
     "nodecomment": null
  }

]}



Метод POST

catGetPricesRest- вернуть цену товара для указанных кодов и шифра фирмы.

В тело сообщения в качестве входных параметров должна передаваться структура следующего вида:

В формате XML

<params xmlns="http://www.tbm.ru/">

  <idParam>1</idParam> 
  <idParam>-8000988165706000</idParam>
  <shifrFir>-33233323</shifrFir>  - шифра фирмы

</params>

Где <idParam>1</idParam> – коды передаваемых товаров. <shifrFir>-33233323</shifrFir> - Шифр фирмы

В формате JSON

{

  "shifrFir": -33233323,
  "idParam":    [
     1,
     -8000988165706000
  ]

}

Возвращается список цен следующей структуры.

В формате XML

<arrayOfTovarPrice xmlns="http://www.tbm.ru/">

  <elements>
     <kodTov>1</kodTov>
     <price>52.46</price>
  </elements>
  <elements>
     <kodTov>-8000988165706000</kodTov>
     <price>189.77</price>
  </elements>

</arrayOfTovarPrice>


{"elements": [

     {
     "kodTov": 1,
     "price": 52.46
  },
     {
     "kodTov": -8000988165706000,
     "price": 189.77
  }

]}