Api doc

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 - анг (не обов'язковий)
Вихідні дані
    для всіх методів
  • 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 - назва бренду (обов'язковий)
  • 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_figure - фігура/стать по замовчуванню в магазині для нового профілю
  • 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 - мовні змінні
перелік вимірів тіла
  • height - Зріст
  • collar - Обхват шиї
  • width_shoulders - Ширина плечей
  • shoulders - Обхват плечей
  • length_shoulders - Довжина руки (від плеча)
  • sleeve_length - Довжина руки (від шиї)
  • forearm - Довжина передпліччя
  • hand - Обхват руки
  • bust- Обхват грудей
  • bust_under - Обхват під грудьми
  • waist - Обхват талії
  • low_waist - Обхват поясу
  • hips - Обхват стегон
  • thigh - Стегно
  • over_knee - Обхват над коліном
  • knee - Обхват коліна
  • under_knee - Обхват під коліном
  • ankle - Обхват голіностопу
  • length_foot - Внут. довжина ноги
  • head - Обхват голови
  • elbow - Обхват ліктя
  • wrist - Обхват зап'ястя
  • palm - Обхват долоні
  • hand_length - Довжина долоні
  • hand_width - Ширина долоні
  • finger_length - Довжина середн. пальця
  • shoes_size - Довжина стопи
  • weight - Вага, кг

 

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 - отримати виміри по брендах у категорії. Використовується при реалізації функціоналу "Мої розміри"

вхідні дані
  • 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"}},
    .....
    }