Update content of files

This commit is contained in:
GitHub Action 2024-08-02 18:23:56 +00:00
parent 997a660e17
commit 73366b5b31
2 changed files with 35 additions and 8 deletions

View file

@ -82,8 +82,6 @@ While <a href="/method/help.getConfig">help.getConfig</a> returns MTProto-specif
<p>Example value of <a href="/constructor/help.appConfig">help.appConfig</a>.<code>config</code>: </p>
<pre><code class="language-json">{
"test": 1,
"keep_alive_service": true,
"background_connection": true,
"emojies_animated_zoom": 0.625,
"emojies_send_dice": [
"\ud83c\udfb2",
@ -204,6 +202,7 @@ While <a href="/method/help.getConfig">help.getConfig</a> returns MTProto-specif
"web.telegram.org",
"web.t.me",
"k.t.me",
"z.t.me",
"a.t.me"
],
"round_video_encoding": {
@ -369,18 +368,28 @@ While <a href="/method/help.getConfig">help.getConfig</a> returns MTProto-specif
"intro_description_length_limit": 70,
"business_chat_links_limit": 100,
"channel_restrict_sponsored_level_min": 50,
"channel_revenue_withdrawal_enabled": true,
"dismissed_suggestions": [],
"stories_pinned_to_top_count_max": 3,
"can_edit_factcheck": false,
"factcheck_length_limit": 1024,
"channel_revenue_withdrawal_enabled": true,
"stars_purchase_blocked": true,
"stars_purchase_blocked": false,
"stories_area_url_max": 3,
"stars_revenue_withdrawal_min": 1000,
"stars_paid_post_amount_max": 2500,
"web_app_allowed_protocols": [
"http",
"https"
]
],
"bot_preview_medias_max": 12,
"ton_proxy_address": "magic.org",
"weather_search_username": "StoryWeatherBot",
"story_weather_preload": true,
"stars_gifts_enabled": true
}</code></pre>
<p>Typical fields included in the resulting JSON object are: </p>
<p>The fields included in the resulting JSON object are: </p>
<h4><a class="anchor" href="#weather-search-username" id="weather-search-username" name="weather-search-username"><i class="anchor-icon"></i></a><code>weather_search_username</code></h4>
<p>Contains the username of the bot used to query the current weather, to use in <a href="/api/stories#weather">weather media areas as specified here »</a>. (string)</p>
<h4><a class="anchor" href="#story-weather-preload" id="story-weather-preload" name="story-weather-preload"><i class="anchor-icon"></i></a><code>story_weather_preload</code></h4>
<p>If set and true, clients should preload the current weather on startup (as opposed to only when creating a <a href="/api/stories#weather">weather media area</a>) by querying the bot specified in <a href="#weather-search-username">weather_search_username</a>. (boolean)</p>
<h4><a class="anchor" href="#emojies-animated-zoom" id="emojies-animated-zoom" name="emojies-animated-zoom"><i class="anchor-icon"></i></a><code>emojies_animated_zoom</code></h4>
<p><a href="/api/animated-emojis">Animated emojis</a> and <a href="/api/dice">animated dice</a> should be scaled by this factor before being shown to the user (float)</p>
<h4><a class="anchor" href="#keep-alive-service" id="keep-alive-service" name="keep-alive-service"><i class="anchor-icon"></i></a><code>keep_alive_service</code></h4>
@ -585,6 +594,8 @@ Note that the stickerset can be fetched using <a href="/constructor/inputSticker
<h4><a class="anchor" href="#stories-entities" id="stories-entities" name="stories-entities"><i class="anchor-icon"></i></a><code>stories_entities</code></h4>
<p>Whether <a href="/api/entities">styled text entities</a> and links in story text captions can be used by all users (<code>enabled</code>), only [Premium](/api/premium users) (<code>premium</code>), or no one (<code>disabled</code>). (string)</p>
<p>This field is used both when posting stories, to indicate to the user whether they can use entities, and when viewing stories, to hide entities (client-side) on stories posted by users whose <a href="/api/premium">Premium</a> subscription has expired (if <code>stories_entities == "premium"</code> and <a href="/constructor/user">user</a>.<code>premium</code> is not set, or if <code>stories_entities == "disabled"</code>). </p>
<h4><a class="anchor" href="#stories-area-url-max" id="stories-area-url-max" name="stories-area-url-max"><i class="anchor-icon"></i></a><code>stories_area_url_max</code></h4>
<p>Maximum number of <a href="/api/stories#media-areas">URL media areas »</a> that can be added to a posted story. (integer)</p>
<h4><a class="anchor" href="#giveaway-gifts-purchase-available" id="giveaway-gifts-purchase-available" name="giveaway-gifts-purchase-available"><i class="anchor-icon"></i></a><code>giveaway_gifts_purchase_available</code></h4>
<p>Whether <a href="/api/giveaways">giveaways</a> can be started by the current user. (boolean)</p>
<h4><a class="anchor" href="#giveaway-add-peers-max" id="giveaway-add-peers-max" name="giveaway-add-peers-max"><i class="anchor-icon"></i></a><code>giveaway_add_peers_max</code></h4>

View file

@ -342,6 +342,22 @@ If the <code>flipped</code> flag is set, the "tail" should be located on the lef
The maximum number of story reaction media areas that can be added to a story is specified by the <a href="/api/config#stories-suggested-reactions-limit-default"><code>stories_suggested_reactions_limit_*</code> »</a> config keys.<br>
Clicking it should invoke <a href="/method/stories.sendReaction">stories.sendReaction</a> as usual.</p>
<p>See <a href="#fetching-the-interaction-list">here »</a> to get more info on how to fetch the reaction list of a <a href="/api/stories">story</a>.</p>
<h4><a class="anchor" href="#urls" id="urls" name="urls"><i class="anchor-icon"></i></a>URLs</h4>
<pre><code><a href='/constructor/mediaAreaUrl'>mediaAreaUrl</a>#37381085 coordinates:<a href='/type/MediaAreaCoordinates'>MediaAreaCoordinates</a> url:<a href='/type/string'>string</a> = <a href='/type/MediaArea'>MediaArea</a>;</code></pre>
<p>URL media areas offer stickers that when clicked, should offer the user a prompt (implemented as a tooltip on the sticker) to open the specified <code>url</code>. </p>
<p>The maximum number of URL media areas that can be added to a story is specified by the <a href="/api/config#stories-area-url-max"><code>stories_area_url_max</code> »</a> config key. </p>
<h4><a class="anchor" href="#weather" id="weather" name="weather"><i class="anchor-icon"></i></a>Weather</h4>
<pre><code><a href='/constructor/mediaAreaWeather'>mediaAreaWeather</a>#49a6549c coordinates:<a href='/type/MediaAreaCoordinates'>MediaAreaCoordinates</a> emoji:<a href='/type/string'>string</a> temperature_c:<a href='/type/double'>double</a> color:<a href='/type/int'>int</a> = <a href='/type/MediaArea'>MediaArea</a>;
---functions---
<a href='/method/messages.getInlineBotResults'>messages.getInlineBotResults</a>#514e999d flags:<a href='/type/%23'>#</a> bot:<a href='/type/InputUser'>InputUser</a> peer:<a href='/type/InputPeer'>InputPeer</a> geo_point:flags.0?<a href='/type/InputGeoPoint'>InputGeoPoint</a> query:<a href='/type/string'>string</a> offset:<a href='/type/string'>string</a> = <a href='/type/messages.BotResults'>messages.BotResults</a>;</code></pre>
<p>Users can now share the weather in their stories by adding one weather media area represented by <a href="/constructor/mediaAreaWeather">mediaAreaWeather</a> to their stories. </p>
<p>The weather media area should be rendered using the background ARGB color specified in <code>color</code>, and should contain the emoji specified in <code>emoji</code>, followed by the temperature specified in <code>temperature_c</code> (Celsius, which should be converted by the client to Fahrenheit if required by the device's settings), followed by <code>°C</code> or <code>°F</code> depending on the unit used. </p>
<p>To fetch the current temperature and emoji to use when <em>creating</em> a weather media area when posting a story, clients should internally make an <a href="/api/bots/inline">inline query</a> with <a href="/method/messages.getInlineBotResults">messages.getInlineBotResults</a> to the <code>bot</code> specified in the <a href="/api/config#weather-search-username">weather_search_username</a> client configuration parameter, passing the user's current location in <code>geo_point</code> and <a href="/constructor/inputPeerEmpty">inputPeerEmpty</a> in <code>peer</code>.<br>
This query will return a single <a href="/constructor/botInlineResult">botInlineResult</a>: the <code>emoji</code> to use will be contained in the <a href="/constructor/botInlineResult">botInlineResult</a>.<code>title</code> and the temperature (always in Celsius) will be contained in <a href="/constructor/botInlineResult">botInlineResult</a>.<code>description</code> (it will contain just the value without the unit, so it can be easily casted to a double). </p>
<p>The inline query should be made internally by the client when the user creates a new weather media area, not by showing the usual inline query UI, but by treating the inline query as an API call to fetch the weather for the current user's location. </p>
<p>If the <a href="/api/config#story-weather-preload">story_weather_preload</a> client configuration parameter is equal to true, clients should preload the weather using the flow specified above on startup (as opposed to only doing it when creating a weather media area). </p>
<h3><a class="anchor" href="#stealth-mode" id="stealth-mode" name="stealth-mode"><i class="anchor-icon"></i></a>Stealth mode</h3>
<p><a href="/api/premium">Premium users</a> may enable <a href="https://telegram.org/tour/stories#stealth-mode">stealth mode</a>, erasing their views from any stories they opened in the past <a href="/api/config#stories-stealth-past-period"><code>stories_stealth_past_period</code> seconds »</a>, and hiding their views on stories for the next <a href="/api/config#stories-stealth-future-period"><code>stories_stealth_future_period</code> seconds »</a>, as specified by the <a href="/api/config#client-configuration">client configuration »</a>.</p>
<p>Schema:</p>