метод REST scope: mailservice

mailservice.update

Изменить почтовый сервис

Кто может выполнять: администратор

Описание

Метод mailservice.update изменяет параметры существующего почтового сервиса.

Параметры

ID integer обязательный

Идентификатор почтового сервиса.

Получить идентификатор можно методом mailservice.list

ACTIVE string необязательный

Признак активности сервиса. Допустимые значения:
- Y — да
- N — нет

NAME string необязательный

Название сервиса

SERVER string необязательный

Адрес IMAP-сервера. В базе сохраняется в нижнем регистре

PORT integer необязательный

Порт IMAP-сервера

ENCRYPTION string необязательный

Признак защищенного подключения. Допустимые значения:
- Y — да
- N — нет

LINK string необязательный

Адрес веб-интерфейса сервиса

ICON file необязательный

Логотип сервиса. Можно передать файл или существующий идентификатор файла

SORT integer необязательный

Индекс сортировки

Примеры запроса

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "ID": 31,
    "NAME": "Обновленный почтовый сервис",
    "ACTIVE": "N",
    "SERVER": "imap.my2-mail.ru",
    "PORT": 993,
    "ENCRYPTION": "Y",
    "LINK": "https://mail.my2-mail.ru/",
    "SORT": 600
  }' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/mailservice.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1774008238,
        "finish": 1774008238.539154,
        "duration": 0.539154052734375,
        "processing": 0,
        "date_start": "2026-03-20T15:03:58+03:00",
        "date_finish": "2026-03-20T15:03:58+03:00",
        "operating_reset_at": 1774008838,
        "operating": 0
    }
}

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

result boolean

true, если сервис успешно обновлен

time time

Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error": "ERROR_CORE",
    "error_description": "Не найден почтовый сервис"
}
Код Описание Значение
400 ERROR_CORE Доступ запрещен
400 ERROR_CORE Не указан ID почтового сервиса
400 ERROR_CORE Не найден почтовый сервис
400 ERROR_CORE Неправильное значение для "*название_поля*"

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.