post_getFile

v1.0.0

Use this method to get basic info about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a 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 again.

Input

{
  "type": "object",
  "required": [
    "file_id"
  ],
  "properties": {
    "file_id": {
      "type": "string",
      "description": "File identifier to get info about"
    }
  }
}

Output

{
  "type": "object",
  "required": [
    "ok",
    "result"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "result": {
      "type": "object",
      "description": "This object represents a file ready to be downloaded. The file can be downloaded via the link `https://api.telegram.org/file/bot<token>/<file_path>`. 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](https://core.telegram.org/bots/api/#getfile).\n\nMaximum file size to download is 20 MB",
      "required": [
        "file_id",
        "file_unique_id"
      ],
      "properties": {
        "file_id": {
          "type": "string",
          "description": "Identifier for this file, which can be used to download or reuse the file"
        },
        "file_path": {
          "type": "string",
          "description": "*Optional*. File path. Use `https://api.telegram.org/file/bot<token>/<file_path>` to get the file."
        },
        "file_size": {
          "type": "integer",
          "description": "*Optional*. File size, if known"
        },
        "file_unique_id": {
          "type": "string",
          "description": "Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file."
        }
      }
    }
  }
}