Проект

Общее

Профиль

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

Редакция 1 (Артем, 27.03.2016 16:06) → Редакция 2/10 (Артем, 27.03.2016 17:02)

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 2 массива данных: 

 h3. Массив parts, subgroups, содержащий список всех запчастей подгрупп выбранной подгруппы з/ч: группы з/ч. 

 Каждая возвращаемая подгруппа это массив вида "ID подгруппы" -> "Массив параметров подгруппы": 
 
 
 |*id*|ID запчасти| подгруппы запчастей| 
 |*callout*|Номер на изображении| 
 |*calloutText*|Текст номера на изображении| 
 |*name*|Название запчасти| 
 |*number*|Номер(артикул) запчасти| 
 |*replaced*|Номер(артикул) замены запчасти| 
 |*replaceType*|Тип замены запчасти| 
 |*additionalInfo*|До|полнительная информация о з/ч| 
 |*dateStart*|Дата начала применения з/ч подгруппы в формате YYYYMMDD| локали каталога| 
 |*dateEnd*|Дата окончания применения з/ч в формате YYYYMMDD| |*-groupId-*|ID объединения подгрупп (не используется)| 
 |*qty*|Количество используемых в узле запчастей| |*-index-*|Не используется| 
 |*usage*|Массив описания применяемости. Может (необязательно) состоять их двух массивов, with и without. Элементы масивов: *id* масива: *name* - ID название параметра применяемости в локали каталога и *value* - значение параметра применяемости в локали каталога| применяемости| 

 h3. Массив images, содержащий список изображений подгрупп выбранной подгруппы з/ч. Каждый элемент в свою очередь состоит из массива: 

 
 |*Filename*|Имя файла с изображением узла| группы з/ч: 
 
 |*id*|ID изображения| 
 |*Callouts*|Массив координат позиции на картинке вида callout->координаты| |*cat_folder*|Подкаталог изображения| 
 |*-ImagePos-*|Не |*img_name*|Имя файла| 
 |*x1*|Координата x1| 
 |*y1*|Координата y1| 
 |*x2*|Координата x2| 
 |*y2*|Координата y2| 
 |*-ref_type-*|Не используется| 
 |*-ref-*|Не используется| 

 Координаты позиции - массив координат вида (x1,y1)(x2,y2) и т.п. Каждая координата - левый-верхний угол соответствующего регина изображения. 


 Полная ссылка на изображения выглядит, например, http://images.neoriginal.ru/getImage.php?catalog=kia&filename=0LBCDB02/661511.png&scale=75&hash=9e5f1b07f9375fc1ee5c0f2818129310. как http://images.neoriginal.ru/kia/Min/0LBCDB02/GI19_15_10_157_122.png, где 
 Подкаталог изображения = 0LBCDB02 
 Имя файла = GI19 
 Координата x1 = 15 
 Координата y1 = 10 
 Координата x1 = 157 
 Координата y2 = 122 

 Хеш изображения можно получить, вызвав метод *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|"Общая информация"]]) 
 Следующий этап поиска - функция getParts. В вызов функции getParts передается в том числе и параметр subgroup, содержащий ID выбранной подгруппы.