Метод Update
Примените метод Update для изменения атрибутов аудиофайла, добавленного в библиотеку приложения. Для этого выполните POST-запрос с входными параметрами к точке подключения, указанными ниже.
Точка подключения:
POST: https://api.exolve.ru/media/v1/Update
Авторизация
Передайте следующие Заголовки HTTP для успешной авторизации.
| Имя | Тип | Описание |
|---|---|---|
| Authorization | string | API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения |
Входные параметры
Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.
| Параметр | Тип | Описание |
|---|---|---|
| resource_id | uint64 | уникальный идентификатор загруженного аудиофайла |
| name | string | новое наименование аудиофайла |
| description | string | новое описание к аудиофайлу |
Выходные параметры
Пустой JSON с 200 OK статусом
Возможные ошибки
| Код | Статус | Пример сообщения | Описание |
|---|---|---|---|
| 400 | Bad Request | “error”: “proto: (line 5:1): invalid value for uint64 type: }” | значение поля resource_id пустое (без “”) |
| 400 | Bad Request | “error”: “invalid UpdateRequest.ResourceId: value must be greater than 0” | значение поля resource_id должно быть больше 0 |
| 400 | Bad Request | “error”: “proto: (line 4:20): invalid value for uint64 type: ""” | не задано значение поля resource_ids |
| 400 | Bad Request | “error”: “proto: (line 4:20): invalid value for uint64 type: "qwe"” | невалидное значение поля resource_ids |
| 400 | Bad Request | “error”: “proto: syntax error (line 3:13): unexpected token ,” | значение поля name пустое (без “”) |
| 400 | Bad Request | “proto: syntax error (line 2:19): unexpected token ,” | значение поля description пустое (без “”) |
| 401 | Unauthorized | malformed token | не указан / неправильно указан API-ключ приложения |
| 404 | Not Found | некорректно введён URL запроса |
Примеры
Входные параметры:
{
"resource_id": "152817",
"name": "Update Test",
"description": "Тест обновления аудиофайла"
}
Выходные параметры:
{}