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*|Текст номера на изображении| |