Привязка одного элемента
Element – это специальный тип данных, который позволяет привязать **один элемент** из коллекции данных.
Этот тип используется для выбора и ссылки на конкретный объект или запись, например, товар, пользователя или категорию.
Как это выглядит?
Привязка создаётся с помощью идентификатора выбранного элемента:
1{
2 "fields": {
3 "element": 115
4 }
5}Когда это нужно?
Выбрать один элемент из списка данных.
Связать объект с конкретной записью, например, выбрать товар для акции.
Организовать привязку элементов внутри платформы OCTAPI.
Пример использования
Допустим, мы хотим привязать один товар из каталога для отображения:
1{
2 "id": 12345,
3 "name": "exampleName",
4 "url": "exampleUrl",
5 "active": false,
6 "fields": {
7 "element": 150,
8 }
9}В этом примере:
"id" – уникальный идентификатор объекта.
"name" – имя объекта, здесь используется "exampleName".
"url" – ссылка или ключ для объекта.
"active" – статус активности объекта (true/false).
"fields" – ключевой блок данных, который содержит привязки по типам:
"element" – привязка одного элемента с идентификатором 150.
Что важно помнить?
Привязка элемента выполняется с использованием его уникального идентификатора (id).
Выбранный элемент должен существовать в коллекции данных.
Этот тип подходит только для **одного** элемента, для множества используйте `elements`.
Подведём итог
Element – это идеальный инструмент для привязки **одного элемента** из коллекции данных. Используйте тип element, чтобы организовать ссылки на объекты и эффективно управлять связями в платформе OCTAPI.