Returns content of a whole file or its part.
upload.file#96a18d5 type:storage.FileType mtime:int bytes:bytes = upload.File;
upload.fileCdnRedirect#f18cda44 dc_id:int file_token:bytes encryption_key:bytes encryption_iv:bytes file_hashes:Vector<FileHash> = upload.File;
---functions---
upload.getFile#b15a9afc flags:# precise:flags.0?true cdn_supported:flags.1?true location:InputFileLocation offset:int limit:int = upload.File;| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| precise | flags.0?true | Disable some checks on limit and offset values, useful for example to stream videos by keyframes |
| cdn_supported | flags.1?true | Whether the current client supports CDN downloads |
| location | InputFileLocation | File location |
| offset | long | Number of bytes to be skipped |
| limit | int | Number of bytes to be returned |
| Code | Type | Description |
|---|---|---|
| 400 | CDN_METHOD_INVALID | You can't call this method in a CDN DC. |
| 400 | CHANNEL_INVALID | The provided channel is invalid. |
| 400 | CHANNEL_PRIVATE | You haven't joined this channel/supergroup. |
| 406 | FILEREF_UPGRADE_NEEDED | The client has to be updated in order to support file references. |
| 400 | FILE_ID_INVALID | The provided file id is invalid. |
| 400 | FILE_REFERENCE_EMPTY | An empty file reference was specified. |
| 400 | FILE_REFERENCE_EXPIRED | File reference expired, it must be refetched as described in the documentation. |
| 420 | FLOOD_PREMIUM_WAIT_%d | Please wait %d seconds before repeating the action, or purchase a Telegram Premium subscription to remove this rate limit. |
| 400 | LIMIT_INVALID | The provided limit is invalid. |
| 400 | LOCATION_INVALID | The provided location is invalid. |
| 400 | MSG_ID_INVALID | Invalid message ID provided. |
| 400 | OFFSET_INVALID | The provided offset is invalid. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
How to handle file references.
Telegram Premium is an optional subscription service that unlocks additional exclusive client-side and API-side features, while helping support the development of the app.