Обработка ошибок

Бизнес-ошибки MindVoice имеют вид {"error":{"code":"...","message":"...","details":{}}}. Не связывайте логику клиента с русским message: используйте HTTP-статус и error.code. Ошибки проверки входных данных могут содержать подробности в details.

HTTP	Типичная причина	Действие
401	Отсутствующий, истёкший или отозванный ключ	Проверьте секрет и срок, выпустите новый ключ при необходимости
403	Недостаточный scope, чужой Workspace или недоступный ключу маршрут	Проверьте права ключа и поддерживаемые операции
404	Неверный или недоступный ID результата/запуска	Проверьте ID и Workspace; результат мог ещё не появиться
409	Конфликт состояния, например ручной запуск до скачивания импортированного файла	Дождитесь нужного состояния и повторите по его контракту
422	Неверное тело, ID, фильтр или формат файла	Исправьте запрос по API Reference
5xx	Ошибка обработки	Повторяйте только после проверки состояния операции

Загрузка и запуск задач могут завершиться ответом до окончания работы. Проверяйте status соответствующей записи или run; HTTP 200 сам по себе не означает успешной транскрибации. Если ответ на платный запуск потерян, сначала найдите его в истории. Для пакетных исполнений передавайте idempotency_key. Не делайте слепой повтор платного одиночного запуска после сетевого таймаута. Поля error_code, error_message, retryable в run помогают определить причину фонового сбоя.