====== content.get_categories.CTYPE ======

Возвращает категории для заданного типа контента.


===== Параметры =====

^ Название ^ Описание ^
| **is_tree** | 1 — возвращать категории, сформированные деревом. Флаг, может принимать значения 1 или 0. Параметр необязательный. |
| **cat_level** | Ограничивает максимальный уровень вложенности возвращаемых категорий. По умолчанию — 0, не ограничивать. Применяется совместно с параметром **is_tree**. Положительное число. Параметр необязательный. |
| **parent_id** | ID родительской категории, от которой нужно получить вложенные. По умолчанию — 1, это корневая категория. Положительное число. Параметр необязательный. |
| **cat_ids** | Идентификаторы категорий (их id), информацию о которых необходимо вернуть. Если этот параметр задан, параметры, описанные выше не учитываются. Список положительных чисел, разделенных запятыми. Параметр необязательный. |

CTYPE в названии метода - это имя типа контента, например news, board и т.п.

===== Пример =====

<code>
instantcms_site.ru/api/method/content.get_categories.articles?api_key=API_KEY&cat_ids=5,9
</code>

===== Результат =====

После успешного выполнения возвращает объект, содержащий общее число категорий типа контента в поле count и массив объектов категорий в поле items.

{{:manual:components:api:methods:content.get_categories.articles.png?nolink|}}

===== Коды ошибок =====

В ходе выполнения могут произойти [[manual:components:api#обработка-ошибок|общие ошибки]].

----
Назад к описанию [[manual:components:api:methods|методов API]]