Метод для редактирования сообщения или комментария.
Для редактирования сообщения вам необходимо знать его id
и указать его в URL
запроса. Все редактируемые параметры сообщения указываются в теле запроса.
Строка content
и массив files
являются обязательными параметрами при редактировании сообщения. Если массив присылается пустым, то вложения сообщения (если они были) удаляются.
Запрос
|
|||
---|---|---|---|
message | object* | Собранный объект параметров редактируемого сообщения | |
content | string* | Текст сообщения | |
files | array of objects* | Прикрепляемые файлы | |
key | string* | Путь к файлу, полученный в результате загрузки файла (каждый файл в каждом сообщении должен иметь свой уникальный key, не допускается использование одного и того же key в разных сообщениях) | |
name | string* | Название файла, которое вы хотите отображать пользователю (рекомендуется писать вместе с расширением) | |
file_type | string* | Тип файла: файл (file), изображение (image) | |
size | integer* | Размер файла в байтах, отображаемый пользователю | |
Ответ
|
|||
data | object | Созданное сообщение | |
id | integer | Идентификатор созданного сообщения | |
entity_type | string | Тип сущности, к которой относится сообщение: беседа/канал (discussion), обсуждение (thread) или пользователь (user) | |
entity_id | integer | Идентификатор сущности, к которой относится сообщение (беседы/канала, обсуждения или пользователя) | |
chat_id | integer | Идентификатор чата, в котором находится сообщение | |
content | string | Текст сообщения | |
user_id | integer | Идентификатор пользователя, создавшего сообщение | |
created_at | string | Дата и время создания сообщения (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ | |
files | array of objects | Прикреплённые файлы | |
id | integer | Идентификатор файла | |
key | string | Путь к файлу | |
name | string | Название файла | |
file_type | string | Тип файла: файл (file), изображение (image) | |
url | string | Прямая временная ссылка на скачивание файла | |
thread | object или null | Обсуждение сообщения. Возвращается как null, если у сообщения нет комментариев. | |
id | integer | Идентификатор обсуждения | |
chat_id | integer | Идентификатор чата обсуждения (используется для отправки новых комментариев в обсуждение и получения списка комментариев) | |
parent_message_id | integer или null | Идентификатор сообщения, к которому написан ответ. Возвращается как null, если сообщение не является ответом. | |
Возможные ошибки запроса (errors code)
|
|||
blank | Поле не может быть пустым | ||
exclusion | Поле имеет недопустимое значение | ||
not_found | Не удалось найти | ||
|
{
"message": {
"content": "Вот попробуйте написать правильно это с первого раза: Будущий, Полощи, Прийти, Грейпфрут, Мозаика, Бюллетень, Дуршлаг, Винегрет.",
"files": []
}
}
{
"data": {
"id": 7231942,
"entity_type": "discussion",
"entity_id": 17452,
"chat_id": 17452,
"content": "Вот попробуйте написать правильно это с первого раза: Будущий, Полощи, Прийти, Грейпфрут, Мозаика, Бюллетень, Дуршлаг, Винегрет.",
"user_id": 65,
"created_at": "2022-06-08T09:32:57.000Z",
"files": [],
"thread": null,
"parent_message_id": null
}
}