Проект

Общее

Профиль

Метод getBrands » История » Версия 2

Артем, 27.02.2019 17:08

1 1 Артем
h1. Метод getBrands
2
3
---
4
5
h2. Описание метода
6
7
---
8
9
p(. Возвращает список доступных производителей автомобилей.
10
11
---
12
13
h2. Параметры вызова
14
15
---
16
17
|=.Параметр|Обязательный|=.Описание|
18
|=.*function*|=.+|getBrands|
19
|=.*apiKey*|=.+|API-ключ|
20
|=.*apiVersion*|=.+|Версия API|
21
|=.*clientId*|=.+|Ваш ID клиента|
22
|=.*domain*|=.+|Домен, для которого сгенерирован API-ключ|
23
24
---
25
26
h2. Пример вызова
27
28
---
29
30
http://api.ilcats.ru/?clientId=1234567890&domain=www.ilcats.ru&apiKey=abxxxxxxxxxxxxxxxxxxxx98&apiVersion=2.0&function=getBrands
31
32
---
33
34
h2. Возвращаемые данные
35
36
---
37
38 2 Артем
p(. Метод возвращает массив значений *values* в формате [[ApiMainDataDescriptionIfList|ifList]], содержащий список брендов.
39 1 Артем
40
41
|=.Название|=.Обязательн.|=.Описание|
42
|=.*id*|=.+|Числовой ID бренда|
43
|=.*name*|=.+|Название бренда|
44
|=.*groupId*|=.+|ID группы каталогов[1]|
45
|=.*groupName*|=.+|Название группы каталогов|
46
|=.*regionId*|=.+|ID региона каталогов[2]|
47
|=.*regionName*|=.+|Название региона каталогов|
48
|=.*urlParams*|=.+|Список параметров вызова следующей функции|
49
50
fn1. В одну группу каталогов может входить несколько брендов, объединенных нами по известным только нам признакам. Используются исключительно для биллинга, выбор нужных групп происходит на стадии подключения API ключа.
51
52
fn2. Исторически сложившееся название "регион" может регионом и не являться. В частности, один из регионов называется "Мотокаталоги". 
53
54
---
55
56
h2. Пример возвращаемых данных
57
58
---
59
60
<pre><code class="ruby">
61
"data": [
62
  {
63
   "values": [
64
     {
65
       "id": 56,
66
       "name": "ABARTH",
67
       "groupId": 54,
68
       "groupName": "FIAT",
69
       "regionId": 3,
70
       "regionName": "Европа",
71
       "brandLatestApiVersion": "2.0",
72
       "urlParams": {
73
          "brand": "abarth"
74
        }
75
     },
76
77
     ...
78
79
     {
80
       "id": 13,
81
       "name": "VW",
82
       "groupId": 2,
83
       "groupName": "VAG",
84
       "regionId": 3,
85
       "regionName": "Европа",
86
       "brandLatestApiVersion": "2.0",
87
       "urlParams": {
88
          "brand": "vw"
89
       }
90
     },
91
     {
92
       "id": 70,
93
       "name": "ZX",
94
       "groupId": 63,
95
       "groupName": "BYD, FAW, ZX",
96
       "regionId": 1,
97
       "regionName": "Китай",
98
       "brandLatestApiVersion": "2.0",
99
       "urlParams": {
100
          "brand": "zx"
101
       }
102
     }
103
   ],
104
   "format": "ifList",
105
   "listItemFormat": [
106
       {
107
         "type": "ifLink",
108
         "caption": "{name}"
109
       }
110
   ]
111
  }
112
]
113
</code></pre>