1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
use crate::client::Bot;
use serde::Serialize;
/// Use this method to get basic information about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a File object is returned. The file can then be downloaded via the link `https://api.telegram.org/file/bot<token>/<file_path>`, where <`file_path`> is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling getFile again.
/// Note: This function may not preserve the original file name and MIME type. You should save the file's MIME type and name (if available) when the File object is received.
/// # Documentation
/// <https://core.telegram.org/bots/api#getfile>
/// # Returns
/// - `crate::types::File`
#[derive(Clone, Debug, Serialize)]
pub struct GetFile {
/// File identifier to get information about
pub file_id: Box<str>,
}
impl GetFile {
/// Creates a new `GetFile`.
///
/// # Arguments
/// * `file_id` - File identifier to get information about
#[must_use]
pub fn new<T0: Into<Box<str>>>(file_id: T0) -> Self {
Self {
file_id: file_id.into(),
}
}
/// File identifier to get information about
#[must_use]
pub fn file_id<T: Into<Box<str>>>(self, val: T) -> Self {
let mut this = self;
this.file_id = val.into();
this
}
}
impl super::TelegramMethod for GetFile {
type Method = Self;
type Return = crate::types::File;
fn build_request<Client>(self, _bot: &Bot<Client>) -> super::Request<Self::Method> {
super::Request::new("getFile", self, None)
}
}