Проект

Общее

Профиль

GetPartsKiaHyundai » История » Редакция 4

Редакция 3 (Артем, 27.03.2016 17:06) → Редакция 4/10 (Артем, 27.03.2016 17:07)

h1. getParts 

 h2. Описание метода 

 --- 

 p(. Метод возвращает список запчастей для выбранной подгруппы 

 h2. Параметры вызова 

 --- 

 p(.  
 |=.параметр|=.обязательный|=.описание| 
 |*apiKey*|=.+|Ваш ключ доступа к API| 
 |*brand*|=.+|kia| 
 |*function*|=.+|getGroups| 
 |*vin*|=.-|vin-номер автомобиля| 
 |*market*|=.+|ID рынка| 
 |*model*|=.+|ID модели| 
 |*modif*|=.-|Список параметров модификации (комплектации) автомобиля| 
 |*group*|=.+|ID группы| 
 |*subgroup*|=.+|ID подгруппы| 
 |*language*|=.-|Язык каталога| 

 p(. <pre>* Здесь и далее для марки Hyundai подставлять brand = hyundai</pre> 

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