Для получения свойств заданного элемента Справочника продуктов следует использовать метод 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). Значения этого свойства используются в печатных формах (ценники и этикеки) для описания состава блюда. Например, как для упомянутой выше Говядина, лопатка б/к, с/м, так и Говядина, грудинка с/м в качестве короткого наименования используется говядина. Поэтому в описании состава блюд, в которые входят эти продукты, выводится говядина, что делает текст более читабельным.
{
"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. Обратитесь в техническую поддержку. | Токен указан неверно. Для решения проблемы следует обратиться в техническую поддержку. |
{
"status": "error",
"code": 1000,
"message": "Неверный token. Обратитесь в техническую поддержку."
}