hints.page.delete

Scope: hints

Кто может вызывать: RestAccess::requireWrite(). Подробнее: Права доступа

Удаляет одну или несколько страниц подсказок.

HTTP: POST

Побочные эффекты: удаляет секции инфоблока, все подсказки (элементы) на этих страницах и записи просмотров (ShowTable) для них.

Параметр ids — массив положительных целочисленных ID; alias: id (один ID или массив). Все указанные страницы должны существовать. Если хотя бы одна страница не найдена, метод вернёт PAGE_NOT_FOUND до начала удаления.

Параметры метода

Параметр Тип Обяз. Описание
ids int|array да* ID страниц для удаления

* Вместо ids можно передать alias id. Требуется хотя бы один из параметров.

Возвращаемые данные

result.result:

Поле Тип Описание
deleted int Число успешно удалённых страниц

Обработка ошибок

Справочник кодов: error-codes.md.

Код Описание
UNAUTHORIZED Пользователь не авторизован
MODULE_DISABLED Модуль выключен на сайте
PERMISSION_DENIED Нет права записи (W)
VALIDATION_ERROR Не переданы ids/id или список содержит некорректный ID
PAGE_NOT_FOUND Одна из указанных страниц не найдена
INTERNAL_ERROR Внутренняя ошибка сервера

Пример запроса (POST)

curl -X POST "https://76592.dev.wehive.digital/rest/1/{webhook_code}/hints.page.delete.json" \
          -H "Content-Type: application/json" \
          -H "Accept: application/json" \
          --data '{
          "id": 98
        }'

Пример ответа

{
          "result": {
            "result": {
              "deleted": 1
            },
            "error": null
          },
          "time": {
            "start": 1788357603,
            "finish": 1788357603.686365,
            "duration": 0.6863648891448975,
            "processing": 0,
            "date_start": "2026-09-02T17:00:03+03:00",
            "date_finish": "2026-09-02T17:00:03+03:00"
          }
        }

См. также

Предыдущая
hints.page.update
Следующая
hints.page.hints