Опубликовать историю.
Раздел API: Истории
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;
| Поле | Тип | Описание |
|---|---|---|
| flags | # | Битовая маска: поле вида flags.N?T присутствует, только если поднят бит N. |
| 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> |
Своих ошибок у этого метода нет: он либо отвечает, либо падает на общих проверках ниже.
| Код | Тип | Что это значит |
|---|---|---|
| 401 | AUTH_KEY_UNREGISTERED |
Сессия неизвестна серверу: ключ отозван, устарел или вызов сделан до авторизации. |
| 401 | API_ID_INVALID |
api_id не выдавался или заблокирован. Ключи выдаёт my.ansible.su. |
| 400 | CONNECTION_LAYER_INVALID |
Клиент не сообщил слой или сообщил слой, которого сервер не знает. |
| 420 | FLOOD_WAIT_X |
Слишком часто. Повторить не раньше чем через X секунд — число приходит в тексте ошибки. |
| 500 | INTERNAL |
Ошибка на нашей стороне. Запрос можно повторить; если повторяется — это баг у нас. |