upload.getFile

Returns content of a whole file or its part.

Example

Javascript

const {Api, TelegramClient} = require('telegram');
const {StringSession} = require('telegram/sessions');

const session = new StringSession('');
const client = new TelegramClient(session, apiId, apiHash, {});

(async function run() {
    const result = await client.invoke(new Api.upload.getFile({
        precise: true,
        cdnSupported: true,
        location: new Api.InputFileLocation({...}),
        offset: 2632318,
        limit: 9694460,
        }));
    console.log(result); // prints the result
})();

TypeScript

import {Api, TelegramClient} from 'telegram';
import {StringSession} from 'telegram/sessions';

const session = new StringSession('');
const client = new TelegramClient(session, apiId, apiHash, {});

(async function run() {
    const result: Api.upload.File = await client.invoke(new Api.upload.getFile({
        precise: true,
        cdnSupported: true,
        location: new Api.InputFileLocation({...}),
        offset: 2632318,
        limit: 9694460,
        }));
    console.log(result); // prints the result
})();

TL schema

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;

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
cdn_supported	flags.1?true	Whether the current client supports CDN downloads
location	InputFileLocation	File location
offset	int	Number of bytes to be skipped
limit	int	Number of bytes to be returned

Result

upload.File

Possible errors

Code	Type	Description
401	AUTH_KEY_PERM_EMPTY	The temporary auth key must be binded to the permanent auth key to use these methods.
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_*	The file reference expired, it must be refreshed
400	FILE_REFERENCE_EXPIRED	File reference expired, it must be refetched as described in https://core.telegram.org/api/file_reference
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

Can bots use this methd ?

yes

Related pages

Encrypted CDNs for Speed and Security

How to handle file references.

File references

How to handle file references.