gamification.shop.category.create
Scope:
gamificationКто может вызывать: Только admin или manager. Подробнее: Права доступа
Создать категорию в магазине бонусов.
HTTP: POST
Побочные эффекты: добавляет раздел инфоблока.
Параметры метода
| Поле / псевдоним | Тип | Обяз. | Описание |
|---|---|---|---|
fields.NAME / name |
string |
да | Название категории |
fields.ACTIVE / active |
string |
нет | Y / N |
fields.SORT / sort |
int |
нет | Порядок сортировки |
fields.IBLOCK_SECTION_ID / iblockSectionId |
int |
нет | ID родительского раздела |
Возвращаемые данные
result.result — объект созданной категории.
Обработка ошибок
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
ACCESS_DENIED |
Вызывающий не является admin/manager |
VALIDATION_ERROR |
Не переданы поля |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/gamification.shop.category.create.json" \
-H "Content-Type: application/json" \
-d '{"fields": {"NAME": "Кафе", "ACTIVE": "Y"}}'
Предыдущая
Следующая