Проект

Общее

Профиль

GetPartsVAG » История » Версия 2

Артем, 22.10.2016 11:57

1 1 Артем
h1. getParts
2
3
h2. Описание метода
4
5
---
6
7
p(. Метод возвращает список запчастей для выбранной подгруппы
8
9
h2. Параметры вызова
10
11
---
12
13
p(. 
14
|=.параметр|=.обязательный|=.описание|
15
|*apiKey*|=.+|Ваш ключ доступа к API|
16 2 Артем
|*apiVersion*|=.+|Версия API|
17 1 Артем
|*brand*|=.+|kia|
18
|*function*|=.+|getGroups|
19
|*vin*|=.-|vin-номер автомобиля|
20
|*market*|=.+|ID рынка|
21
|*model*|=.+|ID модели|
22
|*modif*|=.-|Список параметров модификации (комплектации) автомобиля|
23
|*group*|=.+|ID группы|
24
|*subgroup*|=.+|ID подгруппы|
25
|*imagescale*|=.-|Масштаб изображений|
26
|*language*|=.-|Язык каталога|
27
28
p(. <pre>* Здесь и далее для марки Hyundai подставлять brand = hyundai</pre>
29
30
h2. Возвращаемые данные
31
32
---
33
34
p(. Метод возвращает 3 массива данных:
35
36
h3. 1) Массив parts, содержащий список всех запчастей выбранной подгруппы з/ч:
37
 
38
 
39
|*id*|ID запчасти|
40
|*callout*|Номер на изображении|
41
|*calloutText*|Текст номера на изображении|
42
|*name*|Название запчасти|
43
|*number*|Номер(артикул) запчасти|
44
|*replaced*|Номер(артикул) замены запчасти|
45
|*replaceType*|Тип замены запчасти|
46
|*additionalInfo*|Дополнительная информация о з/ч|
47
|*dateStart*|Дата начала применения з/ч в формате YYYYMMDD|
48
|*dateEnd*|Дата окончания применения з/ч в формате YYYYMMDD|
49
|*qty*|Количество используемых в узле запчастей|
50
|*usage*|Массив описания применяемости. Может (необязательно) состоять их двух массивов, with и without (в первом - опции автомобиля, с которыми деталь применяется, во-втором список опций авто, с которыми деталь не применяется). Элементы масивов: *id* - ID параметра применяемости и *value* - значение параметра применяемости в локали каталога|
51
52
h3. 2) Массив images, содержащий список изображений выбранной подгруппы з/ч. Каждый элемент в свою очередь состоит из массива:
53
54
 
55
|*Filename*|Имя файла с изображением узла|
56
|*Callouts*|Массив координат позиции на картинке вида callout->координаты|
57
|*-ImagePos-*|Не используется|
58
59
Координаты позиции - массив координат вида (x1,y1),(x2,y2) и т.п. Каждая координата - левый-верхний угол соответствующего регина изображения.
60
61
62
Полная ссылка на изображения выглядит, например, http://images.neoriginal.ru/getImage.php?catalog=kia&filename=0LBCDB02/661511.png&scale=75&hash=9e5f1b07f9375fc1ee5c0f2818129310.
63
64
Хеш изображения можно получить, вызвав метод *getImageHash* API сайта. Также Вы можете использовать свой поддомен вида images.ВашСайт.ru (см. [[common_documentation:%D0%9E%D0%B1%D1%89%D0%B0%D1%8F_%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D1%8F|"Общая информация"]])
65
66
h3. 3) Массив linkedGroups, содержащий список подгрупп, связанных с выбранной подгруппой з/ч. Каждый элемент массива, это в свою очередь массив:
67
68
|*group*|ID группы запчастей|
69
|*subgroup*|ID подгруппы запчастей|
70
|*name*|Название подгруппы запчастей|
71
|*callout*|Номер на изображении|
72
|*calloutText*|Текст номера на изображении|