Вы просматриваете документацию API для BigBlueButton 3.x. Текущая версия — BigBlueButton 4.x. Планируете обновление? В руководстве по миграции перечислены все изменения, которые необходимо внести в ваши вызовы API.
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.
state=deleted.Рекомендации
Всегда проверяйте идентификаторы записей с помощью вызова getRecordings перед удалением, чтобы избежать удаления неправильных записей.
Реализуйте в вашем приложении шаг подтверждения перед вызовом этого endpoint, поскольку сам API не требует подтверждения.
Журналируйте каждый запрос на удаление, включая идентификаторы записей и временные метки, чтобы можно было отследить, какие записи были удалены и когда.
При удалении нескольких записей объединяйте их в один запрос со списком, разделённым запятыми, вместо выполнения отдельных вызовов API для каждой записи.
Часто задаваемые вопросы
deleted. Администратор сервера может восстановить их оттуда, пока файлы не будут окончательно удалены процессом очистки. Однако API-эндпоинта для восстановления удалённых записей не существует.recordID. Все указанные записи будут удалены одним вызовом.SUCCESS и применит изменение ко всем действительным записям. Сервер вернёт FAILED с notFound только если ни один из ID не соответствует существующей записи.state в значение deleted или any в вашем вызове getRecordings. По умолчанию удалённые записи скрыты из результатов.