Update

Метод 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": "Тест обновления аудиофайла"  
}

Выходные параметры:

{}

Содержание статьи