Записи

Список записей

GET /api/v1/recordings

Возвращает постраничный список записей, доступных аутентифицированному пользователю.

Параметры запроса

Параметр	Тип	По умолчанию	Описание
`limit`	число	`20`	Количество результатов (1–100)
`offset`	число	`0`	Смещение для пагинации
`search`	строка	-	Фильтр по названию (частичное совпадение)
`status`	строка	-	Фильтр по статусу (см. Статусы записи)
`date_from`	строка	-	Дата в формате ISO 8601 - возвращать только записи, созданные не ранее указанной даты
`date_to`	строка	-	Дата в формате ISO 8601 - возвращать только записи, созданные не позднее указанной даты
`organization_id`	строка	-	Ограничить организацией
`folder_id`	строка	-	Ограничить папкой (требуется `organization_id`)

Ответ

{
  "data": [
    {
      "id": "uuid",
      "status": "COMPLETED",
      "title": "Еженедельная синхронизация",
      "createdAt": "2025-09-19T15:00:00.000Z",
      "thumbnailUrl": "https://...",
      "progress": 1.0,
      "capabilities": {
        "canDownload": true,
        "canShare": true,
        "canViewTranscription": true,
        "canGenerateSummary": true,
        "canAskQuestions": true
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "has_more": true
  }
}

Получить запись

GET /api/v1/recordings/:id

Возвращает полные данные для одной записи.

Ответ

{
  "data": {
    "id": "uuid",
    "status": "COMPLETED",
    "title": "Еженедельная синхронизация",
    "createdAt": "2025-09-19T15:00:00.000Z",
    "updatedAt": "2025-09-19T15:30:00.000Z",
    "startedAt": "2025-09-19T15:01:00.000Z",
    "endedAt": "2025-09-19T15:30:00.000Z",
    "videoUrl": "https://...",
    "hlsUrl": "https://...",
    "downloadUrl": "https://...",
    "downloadUrlExpiresAt": "2025-09-19T21:00:00.000Z",
    "thumbnailUrl": "https://...",
    "organizationId": "org_uuid or null",
    "transcription": {
      "status": "completed",
      "language": "en",
      "speakers": ["Докладчик 1", "Докладчик 2"],
      "segmentsCount": 184,
      "duration": 1740.5
    },
    "summary": {
      "status": "completed",
      "content": "## Ключевые темы\n...",
      "topics": [
        {
          "title": "График проекта",
          "keyPoints": [
            { "point": "Дата запуска подтверждена", "details": ["Запланирована на 1 квартал"] }
          ]
        }
      ]
    },
    "isLocked": false,
    "capabilities": {
      "canDownload": true,
      "canShare": true,
      "canViewTranscription": true,
      "canStartTranscription": true,
      "canRegenerateTranscription": false,
      "canRenameSpeaker": true,
      "canViewSummary": true,
      "canGenerateSummary": true,
      "canAskQuestions": true
    }
  }
}

Получить сегменты расшифровки

GET /api/v1/recordings/:id/transcript

Возвращает постраничные сегменты расшифровки для записи.

Параметры запроса

Параметр	Тип	По умолчанию	Описание
`start_chunk`	число	`0`	Индекс фрагмента, с которого начинать
`limit`	число	`50`	Количество фрагментов (1–100)

Ответ

{
  "data": {
    "status": "completed",
    "language": "en",
    "speakers": ["Докладчик 1", "Элис"],
    "duration": 1740.5,
    "segments": [
      {
        "id": 1,
        "start": 0.5,
        "end": 3.2,
        "text": "Доброе утро всем.",
        "speaker": "Элис",
        "confidence": 0.97
      }
    ],
    "pagination": {
      "total_chunks": 184,
      "has_more": true
    }
  }
}

Обновить запись

PATCH /api/v1/recordings/:id

Обновить название или примечания к записи. Требуется как минимум одно поле.

Тело запроса

{
  "title": "Новое название (1–500 символов)",
  "notes": "Необязательные примечания (макс. 100 000 символов)"
}

Ответ

{
  "data": { "success": true }
}

Удалить запись

DELETE /api/v1/recordings/:id

Окончательное удаление записи и всех связанных с ней данных (расшифровка, сводка, общие доступы).

Ответ

{
  "data": { "success": true }
}

Создать ссылку для общего доступа

POST /api/v1/recordings/:id/share-link

Генерирует публичную ссылку для общего доступа к записи.

Тело запроса

{
  "permission": "view"
}

Значение	Описание
`view`	Получатели могут смотреть видео и получать доступ к расшифровке/сводке
`download`	Получатели также могут скачивать видеофайл

Ответ

{
  "data": {
    "share_url": "https://recordmeeting.com/app/shared/abc123",
    "share_token": "abc123",
    "permission": "view"
  }
}

Статусы записи

Статус	Описание
`STARTING`	Запрос на запись получен, идет настройка
`CONNECTING`	Подключение к сессии Google Meet
`WAIT_APPROVAL`	Ожидание внутрисессионного подтверждения для записи
`RECORDING`	Активная запись
`UPLOADING`	Загрузка на стороне клиента (фрагменты перетекают в хранилище)
`PROCESSING`	Упаковка HLS/DASH в Cloudflare Stream - еще не воспроизводится
`MIGRATING`	Видео полностью воспроизводимо; HLS мигрируется в долгосрочное хранилище
`COMPLETED`	Запись полностью обработана и сохранена
`ERROR`	Ошибка записи

Потребители API должны рассматривать MIGRATING идентично COMPLETED для операций воспроизведения, скачивания и совместного доступа. Различие является внутренним.