mirror of https://github.com/aiogram/aiogram.git synced 2025-12-12 02:03:04 +00:00

Download feature and URLInputFile (#332 )

* Fix How to upload docs

* Rename BaseBot to Bot

* Add download_file method

* Add download method

* Add URLInputFile

* Add Downloadable to __init__ and __all__

* Fix ImportError for Python 3.7

* Related pages

* Improving docs

* Some speed

* staticmethod to classmethod

2020-05-27 01:25:13 +03:00

2.5 KiB

Raw Blame History

sendPhoto

Description

Use this method to send photos. On success, the sent Message is returned.

Arguments

Name	Type	Description
`chat_id`	`#!python3 Union[int, str]`	Unique identifier for the target chat or username of the target channel (in the format @channelusername)
`photo`	`#!python3 Union[InputFile, str]`	Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data.
`caption`	`#!python3 Optional[str]`	Optional. Photo caption (may also be used when resending photos by file_id), 0-1024 characters after entities parsing
`parse_mode`	`#!python3 Optional[str]`	Optional. Mode for parsing entities in the photo caption. See formatting options for more details.
`disable_notification`	`#!python3 Optional[bool]`	Optional. Sends the message silently. Users will receive a notification with no sound.
`reply_to_message_id`	`#!python3 Optional[int]`	Optional. If the message is a reply, ID of the original message
`reply_markup`	`#!python3 Optional[Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]]`	Optional. Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.

Response

Type: #!python3 Message

Description: On success, the sent Message is returned.

Usage

As bot method

result: Message = await bot.send_photo(...)

Method as object

Imports:

from aiogram.methods import SendPhoto
from aiogram.api.methods import SendPhoto
from aiogram.api.methods.send_photo import SendPhoto

In handlers with current bot

result: Message = await SendPhoto(...)

With specific bot

result: Message = await bot(SendPhoto(...))

As reply into Webhook in handler

return SendPhoto(...)

2.5 KiB Raw Blame History