updates.getDifference

Get new updates.

updates.differenceEmpty#5d75a138 date:int seq:int = updates.Difference;
updates.difference#f49ca0 new_messages:Vector<Message> new_encrypted_messages:Vector<EncryptedMessage> other_updates:Vector<Update> chats:Vector<Chat> users:Vector<User> state:updates.State = updates.Difference;
updates.differenceSlice#a8fb1981 new_messages:Vector<Message> new_encrypted_messages:Vector<EncryptedMessage> other_updates:Vector<Update> chats:Vector<Chat> users:Vector<User> intermediate_state:updates.State = updates.Difference;
updates.differenceTooLong#4afe8f6d pts:int = updates.Difference;
---functions---
updates.getDifference#25939651 flags:# pts:int pts_total_limit:flags.0?int date:int qts:int = updates.Difference;

Parameters

Name Type Description
flags # Flags, see TL conditional fields
pts int PTS, see updates.
pts_total_limit flags.0?int For fast updating: if provided and pts + pts_total_limit < remote pts, updates.differenceTooLong will be returned.
Simply tells the server to not return the difference if it is bigger than pts_total_limit
If the remote pts is too big (> ~4000000), this field will default to 1000000
date int date, see updates.
qts int QTS, see updates.

Result

updates.Difference

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 CDN_METHOD_INVALID You can't call this method in a CDN DC
400 DATE_EMPTY Date empty
400 PERSISTENT_TIMESTAMP_EMPTY Persistent timestamp empty
400 PERSISTENT_TIMESTAMP_INVALID Persistent timestamp invalid
401 SESSION_PASSWORD_NEEDED 2FA is enabled, use a password to login
-503 Timeout Timeout while fetching data

Related pages

Working with Updates

How to subscribe to updates and handle them properly.

updates.differenceTooLong

The difference is too long, and the specified state must be used to refetch updates.