Инициализировать соединение: сообщить серверу об устройстве, версии приложения и языке.
Раздел API: Разное
initConnection#c1cd5ea9 {X:Type} flags:# api_id:int device_model:string system_version:string app_version:string system_lang_code:string lang_pack:string lang_code:string proxy:flags.0?InputClientProxy params:flags.1?JSONValue query:!X = X;
| Поле | Тип | Описание |
|---|---|---|
| flags | # | Битовая маска: поле вида flags.N?T присутствует, только если поднят бит N. |
| api_id | int | Идентификатор приложения, выданный на my.ansible.su. |
| device_model | string | Модель устройства — попадёт в список активных сессий. |
| system_version | string | Версия системы — попадёт в список активных сессий. |
| app_version | string | Версия приложения — попадёт в список активных сессий. |
| system_lang_code | string | |
| lang_pack | string | Имя языкового пакета. |
| lang_code | string | Код языка по ISO 639-1. |
| proxy | flags.0?InputClientProxy | |
| params | flags.1?JSONValue | |
| query | !X | Поисковый запрос. |
X
Своих ошибок у этого метода нет: он либо отвечает, либо падает на общих проверках ниже.
| Код | Тип | Что это значит |
|---|---|---|
| 401 | AUTH_KEY_UNREGISTERED |
Сессия неизвестна серверу: ключ отозван, устарел или вызов сделан до авторизации. |
| 401 | API_ID_INVALID |
api_id не выдавался или заблокирован. Ключи выдаёт my.ansible.su. |
| 400 | CONNECTION_LAYER_INVALID |
Клиент не сообщил слой или сообщил слой, которого сервер не знает. |
| 420 | FLOOD_WAIT_X |
Слишком часто. Повторить не раньше чем через X секунд — число приходит в тексте ошибки. |
| 500 | INTERNAL |
Ошибка на нашей стороне. Запрос можно повторить; если повторяется — это баг у нас. |