Uploads a Ansible Story.May also be used in a business connection, not by wrapping the query in invokeWithBusinessConnection », but rather by specifying the ID of a controlled business user in peer.
API section: Working with stories
stories.sendStory#737fc2ec flags:# pinned:flags.2?true noforwards:flags.4?true fwd_modified:flags.7?true peer:InputPeer media:InputMedia media_areas:flags.5?Vector<MediaArea> caption:flags.0?string entities:flags.1?Vector<MessageEntity> privacy_rules:Vector<InputPrivacyRule> random_id:long period:flags.3?int fwd_from_id:flags.6?InputPeer fwd_from_story:flags.6?int albums:flags.8?Vector<int> = Updates;
| Name | Type | Description |
|---|---|---|
| flags | # | Bit mask: a field written flags.N?T is present only when bit N is set. |
| pinned | flags.2?true | Whether it is pinned. |
| noforwards | flags.4?true | |
| fwd_modified | flags.7?true | |
| peer | InputPeer | The user or chat the request is about. |
| media | InputMedia | Attachment. |
| media_areas | flags.5?Vector<MediaArea> | |
| caption | flags.0?string | Caption for the attachment. |
| entities | flags.1?Vector<MessageEntity> | Text markup — bold, links, mentions and so on, as a list of ranges. |
| privacy_rules | Vector<InputPrivacyRule> | |
| random_id | long | A random number from the client. The server uses it to discard duplicates when a request goes out twice. |
| period | flags.3?int | Duration in seconds. |
| fwd_from_id | flags.6?InputPeer | |
| fwd_from_story | flags.6?int | |
| albums | flags.8?Vector<int> |
This method has no errors of its own: it either answers or fails on the shared checks below.
| Code | Type | What it means |
|---|---|---|
| 401 | AUTH_KEY_UNREGISTERED |
The server does not know this session: the key was revoked, expired, or the call was made before authorisation. |
| 401 | API_ID_INVALID |
This api_id was never issued or has been blocked. Keys come from my.ansible.su. |
| 400 | CONNECTION_LAYER_INVALID |
The client did not declare a layer, or declared one the server does not know. |
| 420 | FLOOD_WAIT_X |
Too often. Do not retry for X seconds — the number arrives in the error text. |
| 500 | INTERNAL |
A failure on our side. The request may be retried; if it keeps failing, it is a bug of ours. |