manual:components:api:methods:content-get
Содержание
content.get.CTYPE
Возвращает записи для заданного типа контента.
Параметры
Название | Описание |
---|---|
page | Номер страницы с результатами. Положительное число, по умолчанию — 1. Параметр необязательный. |
cat_id | id категории, записи которой нужно вернуть. Положительное число. Параметр необязательный. |
folder_id | id папки. Положительное число. Параметр необязательный. |
user_id | id пользователя, принадлежащие записи которому нужно вернуть. Положительное число. Параметр необязательный. |
group_id | id группы, принадлежащие записи к которой необходимо вернуть. Положительное число. Параметр необязательный. |
dataset_id | id набора, который нужно применить к списку записей. Положительное число. Параметр необязательный. |
is_not_paginated | 1 — не разбивать результат на страницы. При получении больших объёмов данных не рекомендуется использовать данный параметр. Флаг, может принимать значения 1 или 0. Параметр необязательный. |
ids | Идентификаторы записей (их id), информацию о которых необходимо вернуть. Список положительных чисел, разделенных запятыми. Параметр необязательный. |
Кроме перечисленных выше параметров, метод принимает параметры от полей фильтра (в том числе и от полей свойств). Список полей, по которым можно фильтровать вы можете получить при помощи метода content.get_fields.CTYPE передав ему параметр is_in_filter равный 1. Аналогично выполняется запрос и для полей свойств.
CTYPE в названии метода - это имя типа контента, например news, board и т.п.
Пример
instantcms_site.ru/api/method/content.get.board?api_key=API_KEY
Результат
После успешного выполнения возвращает объект, содержащий общее число записей типа контента в поле count, массив объектов записей в поле items, объект paging разбивки на страницы и объект additionally, в котором показаны объекты:
- категория category, если таковая передана в параметрах;
- текущий тип контента ctype;
- набор dataset, если передан в параметрах;
- список полей fields выбранного типа контента;
- объект filters (в формате
ключ фильтрации ⇒ значение
), если дополнительно список отфильтрован при помощи полей фильтра; - группа group, если таковая передана;
- свойства категорий props, если таковые есть.
Коды ошибок
manual/components/api/methods/content-get.txt · Последнее изменение: 04.09.2017 16:36 — fuze