GetPartsVAG » История » Редакция 5
Редакция 4 (Артем, 22.10.2016 12:39) → Редакция 5/6 (Артем, 22.10.2016 12:39)
h1. getParts
h2. Описание метода
---
p(. Метод возвращает список запчастей для выбранной подгруппы
h2. Параметры вызова
---
p(.
|=.параметр|=.обязательный|=.описание|
|*apiKey*|=.+|Ваш ключ доступа к API|
|*apiVersion*|=.+|Версия API|
|*brand*|=.+|kia|
|*function*|=.+|getGroups|
|*vin*|=.-|vin-номер автомобиля|
|*market*|=.+|ID рынка|
|*model*|=.+|ID модели|
|*modif*|=.-|Список параметров модификации (комплектации) автомобиля|
|*group*|=.+|ID группы|
|*subgroup*|=.+|ID подгруппы|
|*imagescale*|=.-|Масштаб изображений|
|*language*|=.-|Язык каталога|
h2. Возвращаемые данные
---
p(. Метод возвращает 3 массива данных:
h3. 1) Массив parts, содержащий список всех запчастей выбранной подгруппы з/ч:
|*id*|ID запчасти|
|*callout*|Номер на изображении|
|*calloutText*|Текст номера на изображении|
|*name*|Название запчасти|
|*number*|Номер(артикул) запчасти|
|*replaced*|Номер(артикул) замены запчасти|
|*replaceType*|Тип замены запчасти|
|*additionalInfo*|Дополнительная информация о з/ч|
|*dateStart*|Дата начала применения з/ч в формате YYYYMMDD|
|*dateEnd*|Дата окончания применения з/ч в формате YYYYMMDD|
|*qty*|Количество используемых в узле запчастей|
|*usage*|Массив описания применяемости. Может (необязательно) состоять их двух массивов, with и without (в первом - опции автомобиля, с которыми деталь применяется, во-втором список опций авто, с которыми деталь не применяется). Элементы масивов: *id* - ID параметра применяемости и *value* - значение параметра применяемости в локали каталога|
h3. 2) Массив images, содержащий список изображений выбранной подгруппы з/ч. Каждый элемент в свою очередь состоит из массива:
|*filename*|Имя файла с изображением узла|
|*callouts*|Массив координат позиции на картинке вида callout->координаты|
|*-ImagePos-*|Не используется|
Координаты позиции - массив координат вида (x1,y1),(x2,y2) и т.п. Каждая координата - левый-верхний угол соответствующего регина изображения.
Полная ссылка на изображения выглядит, например, http://images.neoriginal.ru/getImage.php?catalog=kia&filename=0LBCDB02/661511.png&scale=75&hash=9e5f1b07f9375fc1ee5c0f2818129310.
Хеш изображения можно получить, вызвав метод *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|"Общая информация"]])
h3. 3) Массив linkedGroups, содержащий список подгрупп, связанных с выбранной подгруппой з/ч. Каждый элемент массива, это в свою очередь массив:
|*group*|ID группы запчастей|
|*subgroup*|ID подгруппы запчастей|
|*name*|Название подгруппы запчастей|
|*callout*|Номер на изображении|
|*calloutText*|Текст номера на изображении|