Ошибки и повторы
Формат ошибки
Ответ ошибки содержит detail: строку, объект с code/message либо список ошибок валидации. Не определяйте поведение по переведённому тексту: используйте HTTP-статус и машинный code, когда он присутствует.
{"detail":"..."}{"detail":{"code":"...","message":"..."}}Коды HTTP
400- Неверный заголовок или идентификатор. Проверьте запрос.
401- Сессия или ключ не приняты. Выполните вход заново или проверьте ключ.
403- Недостаточно прав или доступ к ящику закрыт.
404- Ресурс не найден или недоступен текущему аккаунту.
409- Конфликт состояния, квоты или поколения папки. Обновите данные перед повтором.
413- Размер файла превышает допустимый предел.
422- Неверные параметры запроса. Проверьте поля, указанные в ответе.
429- Слишком много запросов. Повторите запрос позже.
503- Сервис временно недоступен. Повторите запрос с задержкой.
После 401 требуется новый вход. После 409 перечитайте состояние. После 503 повторяйте с задержкой; для отправки сохраняйте прежний Idempotency-Key. Не повторяйте необратимые действия вслепую.