Данный API-метод возвращает перечень каталогов, полей связи и конкретных записей, которые используют указанную запись как связанную, включая метаинформацию о каталогах, правах доступа пользователя и общее количество связанных записей.
Где catalogId в query-параметрах — это ID каталога, по которому формируется фильтрация (возвращаемый каталог). При указании нескольких каталогов они перечисляются через знак &.
fieldId — фильтр по полю связи
Фильтрует записи по конкретному полю типа "связанный каталог" в указанном каталоге.
Важно: Данный фильтр используется только совместно с фильтром catalogId.
Где 2 — это ID поля типа "связанный каталог" в каталоге, указанном в query-параметре catalogId.
Пример с несколькими каталогами:
В этом случае будут отфильтрованы записи:
в каталоге 29 — по полю с id = 6 этого каталога
в каталоге 28 — по полю с id = 6 этого каталога
Фильтрация выполняется отдельно внутри каждого указанного каталога по полю с соответствующим id.
hiddenFields — отображение скрытых полей
Отображает скрытые поля каталога, указанного в query-параметре catalogId. Если в query-параметре не указаны каталоги фильтрации, то отображение сработает по всем связанным каталогам.
По умолчанию скрытые поля не возвращаются.
Пагинация
limit — лимит записей
Ограничивает количество возвращаемых записей.
Допускается использование как с фильтрацией по каталогу/каталогам, так и без дополнительных фильтраций. При использовании limit совместно с фильтром по нескольким каталогам лимит задается на каждый каталог.
Пример:
В таком случае отобразится:
50 записей из каталога 29
50 записей из каталога 28
offset — смещение для пагинации
Количество записей, которое необходимо пропустить для смещения (отсчёт начинается с 0).
При указании нескольких каталогов фильтрации параметр offset применяется ко всем указанным каталогам.
Сортировка
sortField — поле для сортировки
ID поля в каталоге, по которому выполняется сортировка возвращаемых записей.
Допускается использование как с фильтрацией по каталогу/каталогам, так и без дополнительных фильтраций. При использовании sortField совместно с фильтром по нескольким каталогам сортировка задается на каждый каталог.
Пример:
В таком случае сортировка выполнится по следующему принципу:
сортировка значений каталога 29 по его полю с id=7
сортировка значений каталога 28 по его полю с id=7
В случае, если в одном из каталогов отсутствует поле с указанным id для сортировки, значения берутся в том порядке, как они указаны в каталоге.
sortType — тип сортировки
Тип сортировки (работает только совместно с фильтром sortField).
