метод REST scope: im

im.disk.folder.get

Получить папку хранения файлов чата

Кто может выполнять: участник чата

Описание

Устаревший метод

Метод оставлен для поддержки существующих интеграций. Чтобы загрузить файл в чат, папка больше не нужна — используйте im.v2.File.upload.

Метод im.disk.folder.get получает идентификатор папки, в которой хранятся файлы чата.

Идентификатор из ответа можно использовать в методах Диска:
- disk.folder.uploadfile для загрузки файла в папку чата
- disk.folder.getchildren для получения списка файлов папки

Параметры

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

Идентификатор чата. Обязателен, если не передан DIALOG_ID

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

Идентификатор диалога в формате chatXXX, где XXX — идентификатор. Обязателен, если не передан CHAT_ID

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"DIALOG_ID":"chat1489"}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.disk.folder.get

Ответ

HTTP-статус: 200

{
    "result": {
        "ID": 5153
    },
    "time": {
        "start": 1772192121,
        "finish": 1772192121.447936,
        "duration": 0.4479360580444336,
        "processing": 0,
        "date_start": "2026-02-27T14:35:21+03:00",
        "date_finish": "2026-02-27T14:35:21+03:00",
        "operating_reset_at": 1772192721,
        "operating": 0
    }
}

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

result object

Корневой элемент ответа

result.ID integer

Идентификатор папки хранения файлов чата

time time

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

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

HTTP-статус: 400

{
    "error": "CHAT_ID_EMPTY",
    "error_description": "Chat ID can't be empty"
}
Код Описание Значение
400 CHAT_ID_EMPTY Chat ID can't be empty
400 DIALOG_ID_EMPTY Dialog ID can't be empty
403 ACCESS_ERROR You do not have access to the specified dialog

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

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