hints.hint.delete

Scope: hints

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

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

HTTP: POST

Побочные эффекты: удаляет элементы инфоблока.

Параметр ids — массив положительных целочисленных ID; alias: id (один ID или массив). Все указанные подсказки должны существовать. Если хотя бы одна подсказка не найдена, метод вернёт HINT_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
HINT_NOT_FOUND Одна из указанных подсказок не найдена
INTERNAL_ERROR Внутренняя ошибка сервера

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

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

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

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

См. также

Предыдущая
Следующая