Документация
Общие требования к клиентским подключениям. Описание конкретных методов обмена доступно авторизованным пользователям во внутренней вики.
Транспорт
Все подключения выполняются поверх TLS 1.2 и выше. Соединения без шифрования отклоняются на уровне шлюза. Поддерживается keep-alive; неактивные соединения закрываются по истечении времени простоя.
Форматы обмена
Тело запроса и ответа — application/json в кодировке UTF-8.
Даты передаются в формате ISO 8601. Числовые значения передаются без
разделителей разрядов.
Коды ответа
| Код | Значение |
|---|---|
200 | Запрос обработан |
400 | Некорректный формат запроса |
401 | Требуется авторизация |
404 | Ресурс не найден |
429 | Превышена частота обращений |
500 | Внутренняя ошибка обработки |
Ограничение частоты
Для клиентских подключений действует ограничение частоты обращений.
При его превышении шлюз возвращает 429 и заголовок
Retry-After с числом секунд до следующей попытки.
HTTP/1.1 429 Too Many Requests
Retry-After: 30
Content-Type: application/json
{"error": "rate_limited"}
Изменения
Изменения, нарушающие обратную совместимость, анонсируются заранее через внутренние каналы. Версия интерфейса передаётся клиентом в заголовке запроса.