Получить все подарки, которыми владеет собеседник или канал. Метод возвращает и закреплённые в профиле, и остальные — в зависимости от флагов.
Раздел API: Подарки и коллекционные подарки
payments.getSavedStarGifts#a319e569 flags:# exclude_unsaved:flags.0?true exclude_saved:flags.1?true exclude_unlimited:flags.2?true exclude_unique:flags.4?true sort_by_value:flags.5?true exclude_upgradable:flags.7?true exclude_unupgradable:flags.8?true peer_color_available:flags.9?true exclude_hosted:flags.10?true peer:InputPeer collection_id:flags.6?int offset:string limit:int = payments.SavedStarGifts;
| Поле | Тип | Описание |
|---|---|---|
| flags | # | Битовая маска: поле вида flags.N?T присутствует, только если поднят бит N. |
| exclude_unsaved | flags.0?true | |
| exclude_saved | flags.1?true | |
| exclude_unlimited | flags.2?true | |
| exclude_unique | flags.4?true | |
| sort_by_value | flags.5?true | |
| exclude_upgradable | flags.7?true | |
| exclude_unupgradable | flags.8?true | |
| peer_color_available | flags.9?true | |
| exclude_hosted | flags.10?true | |
| peer | InputPeer | Собеседник или чат, к которому относится запрос. |
| collection_id | flags.6?int | |
| offset | string | Сколько записей пропустить от начала выборки. |
| limit | 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 |
Ошибка на нашей стороне. Запрос можно повторить; если повторяется — это баг у нас. |