21  /  41

Получение свойств элемента Справочника продуктов

Для получения свойств заданного элемента Справочника продуктов следует использовать метод GET /products/element/{$id1}/, где {$id1} — уникальный идентификатор ( fc_id) элемента

Параметры запроса GET

Параметр Обязательно Описание
token Да Текущий токен

Пример запроса

	
		GET /api/1.0/products/element/22015/?token=3fca2c2f88d821fd1592b842713d1093 HTTP/1.1
		Host: foodcost.pro
	

Параметры ответа

Свойства Описание Значения
status Статус ответа на запрос success/error
element Массив свойств элемента  
name название продукта  
short_name краткое название продукта, используемое для описания состава блюда  
date_create дата создания продукта формате стандарта ISO 8601  
parent_id уникальный идентификатор (fc_id) родительского раздела  
preview_text краткое описание продукта  
storage_unit код единицы хранения по ОКЕИ  
weight_units вес единицы хранения в граммах  
  nutrients массив нутриентов (Для получение списка нутриентов используйте метод GET /nutrients/):
  nutrient_id id нутриента
  measure краткое название единицы измерения нутриента
  storage_unit код единицы измерения по ОКЕИ
  value значение массы нутриента
  keywords массив с ID ключевых слов продукта. Для получение списка ключевых слов используйте метод GET /products/keywords/list/  
fc_id уникальный идентификатор продукта  
token Новый токен

Краткое наименование продукта
Так как в стандартном названии продукта указываются, в том числе, и его потребительские свойства (например, Говядина, лопатка б/к, с/м и т.п.), мы создали дополнительное свойство Краткое наименование продукта, (short_name). Значения этого свойства используются в печатных формах (ценники и этикеки) для описания состава блюда. Например, как для упомянутой выше Говядина, лопатка б/к, с/м, так и Говядина, грудинка с/м в качестве короткого наименования используется говядина. Поэтому в описании состава блюд, в которые входят эти продукты, выводится говядина, что делает текст более читабельным.

Пример ответа в формате JSON

	
{
    "status": "success",
    "element": {
        "name": "Картофель",
        "short_name": "картофель",
        "date_create": "2018-05-21T13:13:55+03:00",
        "date_update": "2019-03-31T10:43:34+03:00",
        "parent_id": "ps108",
        "preview_text": "Картофель обладает уникальным набором органических и неорганических соединений жизненно важных для человеческого организма",
        "weight_units": "1000",
        "storage_unit": "166",
        "nutrients": [
            {
                "nutrient_id": "9",
                "measure": "г",
                "storage_unit": "163",
                "value": "83.29"
            },
            {
                "nutrient_id": "4",
                "measure": "ккал",
                "storage_unit": "232",
                "value": "58"
            },
            {
                "nutrient_id": "14",
                "measure": "г",
                "storage_unit": "163",
                "value": "2.57"
            },
            {
                "nutrient_id": "37",
                "measure": "г",
                "storage_unit": "163",
                "value": "0.1"
            },
            {
                "nutrient_id": "211",
                "measure": "г",
                "storage_unit": "163",
                "value": "0.026"
            },
            {
                "nutrient_id": "212",
                "measure": "г",
                "storage_unit": "163",
                "value": "0.002"
            },
            {
                "nutrient_id": "213",
                "measure": "г",
                "storage_unit": "163",
                "value": "0.043"
            },
            {
                "nutrient_id": "80",
                "measure": "г",
                "storage_unit": "163",
                "value": "12.44"
            },
            {
                "nutrient_id": "93",
                "measure": "г",
                "storage_unit": "163",
                "value": "2.5"
            },
            {
                "nutrient_id": "123",
                "measure": "мг",
                "storage_unit": "161",
                "value": "11.4"
            },
            {
                "nutrient_id": "124",
                "measure": "мг",
                "storage_unit": "161",
                "value": "0.021"
            },
            {
                "nutrient_id": "125",
                "measure": "мг",
                "storage_unit": "161",
                "value": "0.038"
            },
            {
                "nutrient_id": "127",
                "measure": "мг",
                "storage_unit": "161",
                "value": "1.033"
            },
            {
                "nutrient_id": "132",
                "measure": "мг",
                "storage_unit": "161",
                "value": "0.239"
            },
            {
                "nutrient_id": "143",
                "measure": "мкг",
                "storage_unit": "164",
                "value": "17"
            },
            {
                "nutrient_id": "178",
                "measure": "мг",
                "storage_unit": "161",
                "value": "10"
            },
            {
                "nutrient_id": "176",
                "measure": "мг",
                "storage_unit": "161",
                "value": "23"
            },
            {
                "nutrient_id": "175",
                "measure": "мг",
                "storage_unit": "161",
                "value": "38"
            },
            {
                "nutrient_id": "177",
                "measure": "мг",
                "storage_unit": "161",
                "value": "413"
            },
            {
                "nutrient_id": "174",
                "measure": "мг",
                "storage_unit": "161",
                "value": "30"
            },
            {
                "nutrient_id": "181",
                "measure": "мг",
                "storage_unit": "161",
                "value": "3.24"
            },
            {
                "nutrient_id": "182",
                "measure": "мг",
                "storage_unit": "161",
                "value": "0.35"
            }
        ],
        "keywords": [
            "27"
        ],
        "origin_id": "10",
        "fc_id": "22015"
    },
			"token": "ae41f1c74dbf75593d297fa457d03175"
		}
	

Обратите внимание!
Для доступа к Справочнику продуктов потребуется токен. Не забудьте перезаписать записать новый токен!

Коды ошибок

Код Текст ошибки Причины
3 Request method does not supported Используется неправильный метод запроса
1000 Неверный token. Обратитесь в техническую поддержку. Токен указан неверно. Для решения проблемы следует обратиться в техническую поддержку.

Пример ошибки в формате JSON

	
		{
			"status": "error",
			"code": 1000,
			"message": "Неверный token. Обратитесь в техническую поддержку."
		}
	

0