Описание
Представляет фотографию для отправки.
| Поле | Тип | Описание |
|---|---|---|
| type | String | Тип результата, должен быть photo |
| media | String | Файл для отправки. Передайте file_id для отправки файла, существующего на серверах Telegram (рекомендуется), передайте HTTP URL, чтобы Telegram получил файл из интернета, или передайте «attach://<file_attach_name>» для загрузки нового файла с использованием multipart/form-data под именем <file_attach_name>. Подробнее об отправке файлов » |
| caption | String | Необязательно. Подпись к отправляемой фотографии, 0-1024 символа после обработки сущностей |
| parse_mode | String | Необязательно. Режим обработки сущностей в подписи к фотографии. Подробнее см. параметры форматирования. |
| caption_entities | Array of MessageEntity | Необязательно. Список специальных сущностей, встречающихся в подписи, которые можно указать вместо parse_mode |
| show_caption_above_media | Boolean | Необязательно. Передайте True, если подпись должна отображаться над медиафайлом сообщения |
| has_spoiler | Boolean | Необязательно. Передайте True, если фотографию нужно скрыть анимацией спойлера |
Примеры
json
{
"type": "photo",
"media": "AgACAgQAAxkBAAIBFmY2v6Jq9QABYQABYQABYQABYQABYQACAwADFg5tUAAAAQ",
"caption": "Beautiful sunset over the mountains 🌄",
"parse_mode": "HTML",
"caption_entities": [
{
"type": "bold",
"offset": 0,
"length": 9
}
],
"show_caption_above_media": false,
"has_spoiler": true
}История изменений
- API 5.0. Обновлен объект InputMediaPhoto: Добавлена возможность ручного указания текстовых сущностей
- API 6.4. Обновлен объект InputMediaPhoto: Добавлено поле has_spoiler
- API 7.4. Обновлен объект InputMediaPhoto: Добавлено поле show_caption_above_media
Дополнительно
- MessageEntity - Объект MessageEntity представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.