library.book.propose
Scope:
libraryКто может вызывать: Сотрудник.
HTTP: POST
Побочные эффекты: Создаёт неактивный элемент каталога книг (ACTIVE=N). Если в Bitrix для инфоблока библиотеки есть шаблон бизнес-процесса «Модерация предложенной книги», запускает его — заявка уходит модераторам на согласование. Если шаблон не найден, создаётся только черновик без запуска процесса.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
name |
string |
да | Название заявки |
description |
string |
нет | Описание. Алиасы: annotation |
categoryId |
int |
нет | ID категории. Алиасы: category |
cost |
string |
нет | Цена. Алиасы: price |
link |
string |
нет | Внешняя ссылка |
Возвращаемые данные
| Поле | Тип | Описание |
|---|---|---|
id |
int |
ID созданной заявки (неактивная книга) |
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
VALIDATION_ERROR |
Пустой name (details.field: name); некорректный link (details.field: link); ошибка создания элемента (details.operation: propose) |
Пример запроса (POST)
curl -X POST "https://76590.dev.wehive.digital/rest/1/{webhook_code}/library.book.propose.json"
-H "Content-Type: application/json"
-H "Accept: application/json"
--data '{
"name": "REST docs propose 20260827-105030",
"description": "Заявка на новую книгу",
"categoryId": 135,
"cost": "800",
"link": "https://example.com/propose"
}'
Пример ответа
{
"result": {
"result": {
"id": 1592
},
"error": null
}
}
См. также
Предыдущая
Следующая