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 статусом
Возможные ошибки
Код | Статус | Пример сообщения | Описание |
---|---|---|---|
401 | Unauthorized | malformed token | не указан / не правильно указан API-ключ приложения |
400 | Bad Request | proto: syntax error (line 3:9): invalid character ‘\r’ in string | синтаксическая ошибка |
400 | Bad Request | invalid UpdateRequest.Name: value length must be at most 128 runes | некорректное количество символов в поле numbers |
400 | Bad Request | invalid UpdateRequest.Description: value length must be at most 512 runes | некорректное количество символов в поле numbers |
Примеры
Входные параметры:
{
"resource_id": "152817",
"name": "Update Test",
"description": "Тест обновления аудиофайла"
}
Выходные параметры:
{}