> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aigenda.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Надёжная интеграция

> Таймауты, повторы, потерянные ответы и порядок проверок.

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

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

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

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

```text theme={null}
Звонок · Иван Петров · 2026-10-17 14:30 · crm-48213.mp3
```

Расширение файла по-прежнему стоит в самом конце.

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

Если ответ на `POST …/audio/` (или `by_url/`, `by_youtube/`) не пришёл из-за таймаута или обрыва, запись могла создаться. Не повторяйте запрос вслепую:

1. Найдите запись по названию: `GET /api/spaces/{space_id}/audio/?search=<title>&ordering=-created_at`.
2. Нашли с `is_uploaded: false`: создайте запись заново, а найденную пустую [удалите](/api-reference/audio/delete).
3. Не нашли: создайте запись заново.

## Таймауты

| Запрос | Таймаут |
| - | - |
| Запросы к API | 30 секунд |
| `PUT` части файла | по скорости канала: часть до 1 ГБ на 10 Мбит/с грузится около 15 минут |

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

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

## Токен

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

## Ответ не в JSON

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

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

Опрашивайте `result/` раз в 10–15 секунд, не чаще. Считайте обработку упавшей, если `500` держится дольше 3 минут подряд. Подробнее: [Статусы и ожидание](/processing/status).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.