Пространства и минуты

Пространство объединяет записи, участников и тариф. У каждого аккаунта есть личное пространство. Командные появляются, когда вас приглашают коллеги. Почти все запросы к записям содержат space_id.

Найти space_id

curl "https://api.aigenda.tech/api/spaces/?limit=50&offset=0" \
  -H "Authorization: Bearer <access>"

Ответ 200 (основные поля)

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "is_main_space": true,
      "space": {
        "id": 1024,
        "name": "Личное пространство",
        "description": "Main space",
        "subscribe": {
          "offer": { "name": "PRO", "audio_limit": 72000 },
          "usage_count": 5400,
          "available_usage_count": 66600,
          "is_active": true,
          "end_date": "2026-11-17T00:00:00Z"
        }
      }
    },
    {
      "is_main_space": false,
      "space": { "id": 2048, "name": "Отдел продаж", "description": "Записи звонков с клиентами" }
    }
  ]
}

Личное пространство отмечено is_main_space: true. Его space.id и есть space_id.

Минуты

Тариф и остаток лежат в space.subscribe. Все значения в секундах.

Поле	Что значит
`offer.name`	Название тарифа
`offer.audio_limit`	Сколько секунд даёт тариф за период
`usage_count`	Сколько уже потрачено
`available_usage_count`	Сколько осталось
`end_date`	Когда закончится период

Свежий остаток конкретного пространства отдаёт GET /api/spaces/{space_id}/. Когда списываются минуты. В момент запуска обработки, ровно на длительность записи в целых секундах (запись 71,8 с спишет 71 с). Загрузка без обработки минут не тратит. Если обработка упала, минуты вернутся сами через пару минут.

Перед загрузкой проверьте, что остатка хватает на всю запись с запасом 5 минут. Запись длиннее остатка AiGenda не обработает.

Права

В командном пространстве у вас может не быть права загружать записи. Проверьте его заранее:

curl "https://api.aigenda.tech/api/spaces/1024/my_rights/" \
  -H "Authorization: Bearer <access>"

Загружать записи можно, если в ответе write_access: true. Полный список полей: Права в пространстве.

Постраничный вывод

Списки (пространства, записи, корзина) отдаются страницами. Управляйте ими параметрами limit и offset. Ссылки next и previous в ответе приходят со схемой http://, поэтому собирайте адрес следующей страницы сами: offset = offset + limit, пока offset < count.

Начало работы

Загрузка записи

Обработка и результат

Справка

Пространства и минуты

Найти space_id

Минуты

Права

Постраничный вывод

​Найти space_id

​Минуты

​Права

​Постраничный вывод

Найти space_id

Минуты

Права

Постраничный вывод