diff --git a/data/web/corefork.telegram.org/api/config.html b/data/web/corefork.telegram.org/api/config.html index 7aa6051541..2f580ac6aa 100644 --- a/data/web/corefork.telegram.org/api/config.html +++ b/data/web/corefork.telegram.org/api/config.html @@ -79,7 +79,7 @@ While help.getConfig returns MTProto-specif
  • emojies_sounds - A map of soundbites to be played when the user clicks on the specified animated emoji; the file reference field should be base64-decoded before downloading the file (map of file IDs, with emoji string keys)
  • gif_search_branding - Specifies the name of the service providing GIF search through gif_search_username (string)
  • gif_search_emojies - Specifies a list of emojies that should be suggested as search term in a bar above the GIF search box (array of string emojis)
  • -
  • stickers_emoji_suggest_only_api - Specifies that the app should not display local sticker suggestions for emojis at all and just use the result of messages.getStickers (bool)
  • +
  • stickers_emoji_suggest_only_api - Specifies that the app should not display local sticker suggestions » for emojis at all and just use the result of messages.getStickers (bool)
  • stickers_emoji_cache_time - Specifies the validity period of the local cache of messages.getStickers, also relevant when generating the pagination hash when invoking the method. (int)
  • qr_login_camera - Whether the Settings->Devices menu should show an option to scan a QR login code (boolean)
  • qr_login_code - Whether the login screen should show a QR code login option, possibly as default login method (string, "disabled", "primary" or "secondary")
  • @@ -107,8 +107,8 @@ While help.getConfig returns MTProto-specif
  • channels_limit_premium - The maximum number of channels and supergroups a Premium user may join (integer)
  • saved_gifs_limit_default - The maximum number of GIFs a non-Premium user may save (integer)
  • saved_gifs_limit_premium - The maximum number of GIFs a Premium user may save (integer)
  • -
  • stickers_faved_limit_default - The maximum number of stickers a non-Premium user may add to Favorites (integer)
  • -
  • stickers_faved_limit_premium - The maximum number of stickers a Premium user may add to Favorites (integer)
  • +
  • stickers_faved_limit_default - The maximum number of stickers a non-Premium user may add to Favorites » (integer)
  • +
  • stickers_faved_limit_premium - The maximum number of stickers a Premium user may add to Favorites » (integer)
  • dialog_filters_limit_default - The maximum number of folders a non-Premium user may create (integer)
  • dialog_filters_limit_premium - The maximum number of folders a Premium user may create (integer)
  • dialog_filters_chats_limit_default - The maximum number of chats a non-Premium user may add to a folder (integer)
  • diff --git a/data/web/corefork.telegram.org/api/stickers.html b/data/web/corefork.telegram.org/api/stickers.html index 36bae5003e..d97911626c 100644 --- a/data/web/corefork.telegram.org/api/stickers.html +++ b/data/web/corefork.telegram.org/api/stickers.html @@ -232,8 +232,60 @@ This field is actually used to allow associating more than one emoji to a sticke messages.getFeaturedEmojiStickers#ecf6736 hash:long = messages.FeaturedStickers;

    Telegram showcases a set of featured stickers: they can be fetched using messages.getFeaturedStickers or messages.getFeaturedEmojiStickers, for custom emojis.

    +

    Clients should preload featured stickers on startup according to the value of the preload_featured_stickers configuration parameter.

    The method also returns a set of unread stickerSet IDs in the unread field: use messages.readFeaturedStickers to mark them as read: note that this will only affect the unread field, all stickersets will still be returned, unless you also generate a hash.

    messages.getOldFeaturedStickers can be used to fetch an extended list with even more featured stickersets, that were previously featured in the short list returned by messages.getFeaturedStickers.

    +

    Favorite stickers

    +
    messages.favedStickersNotModified#9e8fa6d3 = messages.FavedStickers;
    +messages.favedStickers#2cb51097 hash:long packs:Vector<StickerPack> stickers:Vector<Document> = messages.FavedStickers;
    +
    +---functions---
    +
    +messages.faveSticker#b9ffc55b id:InputDocument unfave:Bool = Bool;
    +messages.getFavedStickers#4f1aaa9 hash:long = messages.FavedStickers;
    +

    A stickerset can be faved or unfaved using messages.faveSticker.

    +

    Favorited stickers can be fetched using messages.getFavedStickers: note that this method returns a set of stickerset previews ».

    +

    Users can fave only a certain number of stickersets, as specified by the following configuration parameters:

    + +

    Recent stickers

    +
    messages.recentStickersNotModified#b17f890 = messages.RecentStickers;
    +messages.recentStickers#88d37c56 hash:long packs:Vector<StickerPack> stickers:Vector<Document> dates:Vector<int> = messages.RecentStickers;
    +
    +---functions---
    +
    +messages.saveRecentSticker#392718f8 flags:# attached:flags.0?true id:InputDocument unsave:Bool = Bool;
    +messages.getRecentStickers#9da9403b flags:# attached:flags.0?true hash:long = messages.RecentStickers;
    +messages.clearRecentStickers#8999602d flags:# attached:flags.0?true = Bool;
    +

    After using a sticker in a message, clients should invoke messages.saveRecentSticker (normal and mask stickers only, mask stickers should set the attached flag).

    +

    A sticker can be then removed from the recent stickers list using messages.saveRecentSticker with unsave=true; the entire list can be cleared using messages.clearRecentStickers.

    +

    Use messages.getRecentStickers to fetch the recent stickers list.

    +

    Users can add only a certain number of recent stickers, according to the value of the stickers_recent_limit configuration parameter.

    +

    Sticker suggestions

    +
    messages.stickersNotModified#f1749a22 = messages.Stickers;
    +messages.stickers#30a6ec7e hash:long stickers:Vector<Document> = messages.Stickers;
    +
    +---functions---
    +
    +messages.getStickers#d5a5d3a1 emoticon:string hash:long = messages.Stickers;
    +

    Clients should show a popup with a list of suggested stickers and custom emojis when the user enters an emoji in the text bar.

    +

    If the stickers_emoji_suggest_only_api app configuration parameter is set to true, clients must invoke messages.getStickers to fetch a list of suggested stickers for the emoji.
    +The stickers_emoji_cache_time specifies the validity period of the local cache of messages.getStickers, also relevant when generating the pagination hash when invoking the method.

    +

    Otherwise, the following local logic should be used.

    +

    Archived stickers

    messages.archivedStickers#4fcba9c8 count:int sets:Vector<StickerSetCovered> = messages.ArchivedStickers;
     
    @@ -245,41 +297,7 @@ This field is actually used to allow associating more than one emoji to a sticke
     messages.getArchivedStickers#57f17692 flags:# masks:flags.0?true emojis:flags.1?true offset_id:long limit:int = messages.ArchivedStickers;

    One or more stickersets can be archived (or unarchived) using messages.installStickerSet with archived=true|false, or messages.toggleStickerSets with either the archive or unarchive flag.

    An unused stickerset may also be automatically archived when installing new stickersets.

    -

    Archived stickers are not returned by messages.getAllStickers and can only be fetched using messages.getArchivedStickers: note that this method returns a set of stickerset previews ».

    -

    Recent stickers

    -
    messages.recentStickersNotModified#b17f890 = messages.RecentStickers;
    -messages.recentStickers#88d37c56 hash:long packs:Vector<StickerPack> stickers:Vector<Document> dates:Vector<int> = messages.RecentStickers;
    -
    ----functions---
    -
    -messages.saveRecentSticker#392718f8 flags:# attached:flags.0?true id:InputDocument unsave:Bool = Bool;
    -messages.getRecentStickers#9da9403b flags:# attached:flags.0?true hash:long = messages.RecentStickers;
    -messages.clearRecentStickers#8999602d flags:# attached:flags.0?true = Bool;
    -

    Favorite stickers

    -
    messages.favedStickersNotModified#9e8fa6d3 = messages.FavedStickers;
    -messages.favedStickers#2cb51097 hash:long packs:Vector<StickerPack> stickers:Vector<Document> = messages.FavedStickers;
    -
    ----functions---
    -
    -messages.faveSticker#b9ffc55b id:InputDocument unfave:Bool = Bool;
    -messages.getFavedStickers#4f1aaa9 hash:long = messages.FavedStickers;
    -

    A stickerset can be faved or unfaved using messages.faveSticker.

    -

    Favorited stickers can be fetched using messages.getFavedStickers: note that this method returns a set of stickerset previews ».

    -

    Sticker suggestions

    -
    messages.stickersNotModified#f1749a22 = messages.Stickers;
    -messages.stickers#30a6ec7e hash:long stickers:Vector<Document> = messages.Stickers;
    -
    ----functions---
    -
    -messages.getStickers#d5a5d3a1 emoticon:string hash:long = messages.Stickers;
    - +

    Archived stickers are not returned by messages.getAllStickers and can only be fetched using messages.getArchivedStickers: note that this method returns a set of stickerset previews ».