Как включить запись в инфоблок
Настройки модуля -> вкладка «Инфоблоки» -> инфоблок слева -> таб «Запись».
| Настройка | Что значит |
|---|---|
| Кто создаёт | Никто (по умолчанию) / Авторизованные / Все, включая гостей |
| Изменение, Удаление | Запрещено / Только своё (только автор элемента) |
| Кто видит | Все элементы / Только свои (см. Личные данные) |
| Новые элементы | Сразу активны / На модерации (неактивны, пока администратор не включит) |
| Капча для гостей | Гость передаёт токен reCAPTCHA в поле captchaToken |
| Лимит создания с IP в час | Сколько элементов гость создаёт с одного адреса за час; 0 — без лимита |
| Принимаемые данные | Чипами: поля элемента и свойства инфоблока |
Принимаются только отмеченные чипами поля и свойства, остальное игнорируется (например, гость не может передать previewText, если он не выбран). Чипы свойств меняют штатный флаг свойства «Принимать в POST запросах через BIK.REST API». Поля элемента: название, символьный код, анонс, детальный текст, картинки анонса и детальная, раздел, даты активности.
Методы появляются сами: создание — если создавать может хоть кто-то, изменение и удаление — при «Только своё». После сохранения настроек кеш сбрасывается, в документации API инфоблока появляются методы с примером запроса, собранным из ваших чипов.
Создание: POST
Допустим, у инфоблока «Заявки» с кодом API requests создание разрешено всем, принимаются «Название» и свойство «Телефон» (код PHONE). Ключи тела — camelCase: поле name, свойство phone.
curl -i -X POST "https://example.ru/api/iblock/requests/elements" \
-H "Content-Type: application/json" \
-d '{"name": "Перезвоните мне", "phone": "+7 900 000-00-00", "captchaToken": "..."}' HTTP/1.1 200 OK
X-Session-Id: JLfAjGOFZ3qb2elyU2VIxlhvt1kYjQMZ {
"data": { "id": 501 },
"success": true
} Метод начинает сессию: ID приходит в заголовке X-Session-Id (см. Сессия и авторизация). Тело — JSON или форма; файлы свойств и картинки — multipart/form-data. Если Битрикс отказал в сохранении, текст попадает в errors со статусом 200.
Изменение и удаление: PUT, DELETE
Только автор элемента и только если разрешено «Только своё». Передаются только изменяемые поля:
curl -X PUT "https://example.ru/api/iblock/requests/elements/501" \
-H "Content-Type: application/json" -H "X-Session-Id: JLfAjGOFZ3qb2elyU2VIxlhvt1kYjQMZ" \
-d '{"name": "Перезвоните после 18:00"}'
curl -X DELETE "https://example.ru/api/iblock/requests/elements/501" \
-H "X-Session-Id: JLfAjGOFZ3qb2elyU2VIxlhvt1kYjQMZ" Успех — {"success": true}.
Отказы
Каждый отказ объясняется текстом в поле error:
| Статус | Текст | Когда |
|---|---|---|
| 401 | Войдите, чтобы отправить | создавать могут только авторизованные; или гость меняет или удаляет |
| 400 | Подтвердите, что вы не робот | включена капча, токена нет или он неверный |
| 429 | Слишком много отправок, попробуйте позже | гость превысил лимит с адреса |
| 403 | Изменять можно только свои записи | вошёл не автор элемента |
| 404 | Не найдено | запись в инфоблок выключена (метода нет) |
{
"success": false,
"error": "Слишком много отправок, попробуйте позже"
} Гость не может изменить или удалить ни один элемент. Нужен сторонний вывод ответа (например, сообщение «Спасибо») — используйте событие OnAfterIblockPostElements.
Модерация
При «Новые элементы: На модерации» созданный элемент неактивен и не виден в списке, пока администратор его не активирует. Автор видит его через own=Y.