Перейти к основному содержанию

​
Перед загрузкой

  1. Получите свежий остаток минут: GET /api/spaces/{space_id}/, поле subscribe.available_usage_count.
  2. Убедитесь, что остатка хватает на запись с запасом 5 минут.
  3. В командном пространстве проверьте write_access в my_rights/.

​
Уникальные названия

Добавляйте в title метку, по которой вы найдёте запись: дату, время, идентификатор из вашей системы.
Расширение файла по-прежнему стоит в самом конце.

​
Потерянный ответ на создание записи

Если ответ на POST …/audio/ (или by_url/, by_youtube/) не пришёл из-за таймаута или обрыва, запись могла создаться. Не повторяйте запрос вслепую:
  1. Найдите запись по названию: GET /api/spaces/{space_id}/audio/?search=<title>&ordering=-created_at.
  2. Нашли с is_uploaded: false: создайте запись заново, а найденную пустую удалите.
  3. Не нашли: создайте запись заново.

​
Таймауты

​
Ссылки для загрузки живут 5 часов

Создавайте запись прямо перед загрузкой. Если между созданием и загрузкой прошло больше 5 часов, создайте запись заново, а старую удалите.

​
Токен

Получайте новый токен по почте и паролю, когда до истечения access осталось меньше суток или API ответил 401. Подробнее: Авторизация.

​
Ответ не в JSON

Изредка API отвечает не JSON, а HTML-страницей ошибки. Проверяйте Content-Type перед разбором. Для безопасных запросов (GET, вход) повторите запрос через 1–2 секунды.

​
Ожидание результата

Опрашивайте result/ раз в 10–15 секунд, не чаще. Считайте обработку упавшей, если 500 держится дольше 3 минут подряд. Подробнее: Статусы и ожидание.
Последнее изменение 17 октября 2026 г.