Версия API: 4.x последняя 3.x

Вы просматриваете документацию API для BigBlueButton 3.x. Текущая версия — BigBlueButton 4.x. Планируете обновление? В руководстве по миграции перечислены все изменения, которые необходимо внести в ваши вызовы API.

Глава 13 GET

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

Конечная точка deleteRecordings удаляет одну или несколько записей с вашего сервера BigBlueButton. Можно передать один идентификатор записи или список идентификаторов через запятую, чтобы удалить несколько записей одним запросом.

Этот вызов API вступает в силу немедленно, без какого-либо запроса на подтверждение. Убедитесь, что у вас правильные ID записей, прежде чем отправлять запрос. Удалённые записи нельзя восстановить через API.

Конечная точка

GET https://api-guide.bbbserver.com/bigbluebutton/api/deleteRecordings?<parameters>&checksum=replace-with-checksum

Параметры

Параметр Тип Обязательно По умолчанию Описание
recordID String Да — Один идентификатор записи или список идентификаторов записей, разделённых запятыми, для удаления.

Пример запроса

Удалить одну запись:

https://api-guide.bbbserver.com/bigbluebutton/api/deleteRecordings?recordID=replace-with-recording-id&checksum=replace-with-checksum

Удалить несколько записей за один вызов:

https://api-guide.bbbserver.com/bigbluebutton/api/deleteRecordings?recordID=replace-with-recording-id-1,replace-with-recording-id-2&checksum=replace-with-checksum

Пример ответа

Успешный вызов возвращает следующий XML:

<response>
  <returncode>SUCCESS</returncode>
  <deleted>true</deleted>
</response>

Ответы с ошибками

messageKey Описание
checksumError checksum недействителен.
missingParamRecordID Параметр recordID не был передан.
notFound На сервере не найдена запись с указанным идентификатором.

Записи не удаляются с диска физически сразу. Сервер перемещает файлы в каталог deleted/. Администратор сервера потенциально может восстановить удалённые записи из этого каталога до их окончательной очистки.

Поведение после удаления

  • Статус записи изменяется на deleted.
  • Удалённые записи больше не отображаются в стандартных ответах getRecordings.
  • Чтобы получить удалённые записи через API, передайте state=deleted или state=any в качестве параметра state в вызове getRecordings.
На bbbserver.de записи удаляются безвозвратно. После этого их больше нельзя получить, даже с помощью state=deleted.

Рекомендации

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

Реализуйте в вашем приложении шаг подтверждения перед вызовом этого endpoint, поскольку сам API не требует подтверждения.

Журналируйте каждый запрос на удаление, включая идентификаторы записей и временные метки, чтобы можно было отследить, какие записи были удалены и когда.

При удалении нескольких записей объединяйте их в один запрос со списком, разделённым запятыми, вместо выполнения отдельных вызовов API для каждой записи.

Часто задаваемые вопросы

Не сразу. Сервер перемещает файлы записи в специальный каталог deleted. Администратор сервера может восстановить их оттуда, пока файлы не будут окончательно удалены процессом очистки. Однако API-эндпоинта для восстановления удалённых записей не существует.

Да. Передайте список ID записей, разделённый запятыми, в параметре recordID. Все указанные записи будут удалены одним вызовом.

Если хотя бы один из переданных ID записей действителен, вызов вернёт SUCCESS и применит изменение ко всем действительным записям. Сервер вернёт FAILED с notFound только если ни один из ID не соответствует существующей записи.

Да, но только если вы явно запросите их, установив параметр state в значение deleted или any в вашем вызове getRecordings. По умолчанию удалённые записи скрыты из результатов.

Нет. API BigBlueButton не предоставляет эндпоинт для восстановления удалённых записей. Восстановление возможно только на уровне файловой системы сервера системным администратором.
Руководство по API BigBlueButton