Документація по API
LookSize API v2.1
Виклик методу відбувається через HTTPS запит по URL: https://www.looksize.com/api.php
Вхідні дані приймаються як в GET, так і POST запитах, у випадку одночасному GET і POST запиті GET-дані мають приорітет. Всі дані слід надсилати в кодуванні UTF-8
Вихідні дані в форматі JSON
- для всіх методів
- api_key - ключ доступу до API (обов'язковий), отримати ключ можна в Кабінеті / Налаштування віджету
api_key привязується до домену, якщо необхідно вказати декілька доменів зверніться до менеджера LookSize
- act - назва методу (обов'язковий)
- lang - мова ua - укр, ru - рос, en - анг (не обов'язковий)
- secret - приватний ключ доступу до API для запитів через cURL
- для всіх методів
- time - timestamp
- run_time - час виконання
- result :success/error - успішно/помилка
- error - повідомлення
успішно:
{"size":{...},...,"response":"success","run_time":0.059,"time":1600249590}
помилка:
{"error":"empty param api_key","response":"error","run_time":0.005,"time":1600250319}
Список методів
getData - отримати результат виміруювання
- {
- category - ідентифікатор категорії в магазині (необхідно щоб була відповідність до категорії одягу LookSize) (обов'язковий один із параметрів category або category_id )
- category_id - ідентифікатор категорії одягу LookSize (обов'язковий один із параметрів category або category_id )
- brand - назва бренду (обов'язковий)
- gender - стать (слід вказати якщо категорія не визначає стать )
- page_url - url сторінки товару кодований base64encode
- userKey - ідентифікатор профілю користувача
- userSize - дані текучого профілю , якщо були змінені
{"userSize":{"name":"test","gender":"male",.....}} - profile - дані профілю (при створені чи редагування)
- {
- act - операції з профілем, допустимі значенні: save, delete
- userKey - ідентифікатор профілю користувача
- name - назва профілю (обов'язковий)
- gender - стать, допустимі значенні: female, male (обов'язковий)
- fit - прилягання, допустимі значенні: norm, tight, wide, too_tight, too_wide ( позамовчуванню: norm)
- new:1 - признак нового профілю
- bust:90 - вимірів тіла, см
- ... }
- size - об'єк перелік вимірів
{"size":{
{"bust":{"id":"bust","name":"bust","caption":"Обхват грудей","min_val":"50","max_val":"190","size_id":"2","figure":"","hide2gender":"0","video":{"url":"https://www.looksize.intelexcanada.com/UserFiles/sc_size/bust_female.gif","title":"Як правильно виміряти обхват грудей"}}}
....
}
} - profile_list - список профілів користувача
{"profile_list":{
"LS.....":{"name":"test","gender":"male"},
"LS.....":{"name":"test2","gender":"female"},
.....
}} - userKey - ідентифікатор текучого профілю користувача
- userSize - дані текучого профілю користувача
{"userSize":{"name":"test","gender":"male",.....}} - shop_gender - фігура/стать по замовчуванню в магазині для нового профілю
- base_figure - базова фігура/стать
- category - категорія одягу магазину
- category_id - ID визначеної категорії(типу одягу) LookSize
- category_name - Назва визначеної категорії LookSize
- brand - бренд магазину
- brand_name - Назва визначеного бренду LookSize
- brand_file - логотип бренду
- brandSize - розмірна таблиця бренду
{"brandSize":{
"type_id":"3",
"available_standart":{"world":"Міжнародний стандарт","ua":"Український стандарт","us":"Американський стандарт","eu":"Європейський стандарт"},
"standart":"world",
"need":{"bust":"2","waist":"5","hips":"6"},
"size_brand":{"_2":{ "standart":{"world":"XS","ua":"40","us":"6","eu":"34"}, "size":{"bust":{"min_val":78,"max_val":81},"waist":{"min_val":63,"max_val":65},"hips":{"min_val":88,"max_val":91}} },
......
}
}}
- current:"_2" - ID визначеного розміру brandSize.size_brand["_2"]
- userBrandSize - визначений розмір по стандартах
{"userBrandSize":{"world":"XS","ua":"40","us":"6","eu":"34"}} - user_size_standart - визначений розмір у вибраному стандарті
- different - відхилення по розмірах у вимірах тіла
{"different":{
"_2":{
"total":0.078,
"bust":{"fit":3,"dev":-4,"diff":0,"sign":"0","points":0.035},
"waist":{"fit":3,"dev":0,"diff":0,"sign":"0","points":0.018},
"hips":{"fit":3,"dev":0,"diff":0,"sign":"0","points":0.025},"avg":0.026},
....
}} - fit - прилягання (довідник для different.bust.fit)
{"fit":{"1":"надто вільно","2":"вільно","3":"нормально","4":"щільно","5":"надто щільно"}} - nearest - ID визначеного найближчого розміру
- nearestSize - найближчий визначений розмір по стандартах
- nearestSize_standart - найближчий визначений розмір у вибраному стандарті
- showSize - ID розміру для відображення
- actionKey - ключ результатів виміру, використовується для привязки результатів вимірів до замовлення чи перегляді результатів магазином
- btn_user_size - результат виміру для виводу
- figure - перелік фігур для відображення
{"figure":{"shop":"male","base":"female","user":"female","category":""}} - user_fit - довідник прилягань для профілю
{"user_fit":{"norm":"нормальне","tight":"щільне","wide":"вільне","too_tight":"дуже щільне","too_wide":"дуже вільне"}} - LANG - мовні змінні
- head_circ - Обхват голови
- shoulders_width - Ширина плечей
- shoulder_circ - Обхват плечей
- neck_circ - Обхват шиї
- above_bust - Обхват над грудьми
- chest_circ - Обхват грудей
- underbust - Обхват під грудьми
- waist - Обхват талії
- waist_lower_belt - Обхват поясу
- hips - Обхват стегон
- thigh_circ - Обхват стегна
- arm_length_neck - Довжина руки (від шиї)
- arm_length_shoulder - Довжина руки (від плеча)
- inner_arm_length - Внут. довжина руки
- elbow_circ - Обхват ліктя
- forearm_circ - Обхват передпліччя
- forearm_length - Довжина передпліччя
- arm_circ - Обхват руки
- wrist_circ - Обхват зап'ястя
- palm_width - Ширина долоні
- palm_circ - Обхват долоні
- hand_length - Довжина долоні
- middle_finger_length - Довжина середн. пальця
- back_length - Довжина спини
- leg_length_belt - Довжина ноги (від поясу)
- inseam - Внут. довжина ноги
- above_knee_circ - Обхват над коліном
- knee_circ - Обхват коліна
- under_knee_circ - Обхват під коліном
- calf_circ - Обхват литки
- ankle_circ - Обхват щиколотки
- foot_length - Довжина стопи
- foot_width - Ширина стопи
- foot_arch - Звід стопи
- insole_length - Довжина устілки
- trouser_length - Довжина штанини
- crotch - Обхват промежини
- thing_length - Довжина виробу
- height - Зріст
- weight - Вага
- birth_year - Рік народження
- age - Вік
setData - запис даних
- userKey - ідентифікатор текучого профілю користувача
- userSize - дані текучого профілю користувача
{"userSize":{"name":"test","gender":"male",.....}} - profile - дані профілю (при створені чи редагування)
- userKey - ідентифікатор текучого профілю користувача
- userSize - дані текучого профілю користувача
{"userSize":{"name":"test","gender":"male",.....}}
checkIsFilter - перевірка доступності даних для функціоналу "Мої розміри"
- category - ідентифікатор категорії в магазині (необхідно щоб була відповідність до категорії одягу LookSize) (обов'язковий один із параметрів category або category_id )
- category_id - ідентифікатор категорії одягу LookSize (обов'язковий один із параметрів category або category_id )
- userKey - ідентифікатор текучого профілю користувача
- isFilter:1 - є дані для функціоналу "Мої розміри"
getDataByBrand - отримати виміри по брендах у категорії. Використовується при реалізації функціоналу "Мої розміри"
Для запиту слід використовувати cURL з додатковим параметром secret
- category - ідентифікатор категорії в магазині (необхідно щоб була відповідність до категорії одягу LookSize) (обов'язковий один із параметрів category або category_id )
- category_id - ідентифікатор категорії одягу LookSize (обов'язковий один із параметрів category або category_id )
- userKey - ідентифікатор текучого профілю користувача
- userSizeByBrand - список брендів з визначеними розмірами користувача
"userSizeByBrand":{
"9":{"brand":"adidas","ls_brand":"Adidas","size":{"world":"XS"}, "nearest":{"world":"S"} },
"11":{"brand":"Nike","ls_brand":"Nike","size":{"world":"XS","eu":"32/34","us":"0/2","ua":"40/42"}},
.....
}