Home › Methods › Upload › GetFile
Layer 220

UploadGetFile

Returns content of a whole file or its part.

method Users Bots
upload.getFile#be5335be flags:# precise:flags.0?true cdn_supported:flags.1?true location:InputFileLocation offset:long limit:int = upload.File;

Parameters

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
CdnSupported 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

Returns

upload.File

Possible Errors

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.
400 FILE_REFERENCE_INVALID The specified file reference is invalid.
420 FLOOD_PREMIUM_WAIT_%d Please wait <number> 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.

Gogram Example

// UploadGetFile - using Params struct
result, err := client.UploadGetFile(&tg.UploadGetFileParams{
    Location: &tg.InputFileLocation{},
    Offset: int64(0),
    Limit: 0,

    // Optional fields:
    // Precise: true,
    // CdnSupported: true,
})
if err != nil {
    // handle error
}
// result is *tg.UploadFile