Cloud Services

Документация

Общие требования к клиентским подключениям. Описание конкретных методов обмена доступно авторизованным пользователям во внутренней вики.

Транспорт

Все подключения выполняются поверх 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"}

Изменения

Изменения, нарушающие обратную совместимость, анонсируются заранее через внутренние каналы. Версия интерфейса передаётся клиентом в заголовке запроса.