Audio API

API используемое для загрузки аудио

Сущности

• Плейлист
• Аудио

Плейлист

• audios - массив аудио
• id - строка - идентификатор уникальный в пределах менеджера
• manager - строка - использованный менеджер
• title - строка - название

Аудио

• artist - строка - исполнитель
• duration - число - длительность в секундах
• id - строка - идентификатор уникальный в пределах менеджера
• manager - строка - использованный менеджер
• title - строка - название

Авторизация

Для авторизации используется Bearer-токен, передаваемый в заголовке Authorization в следующем формате: Bearer TOKEN_GOES_HERE

Поиск аудио

Запрос

curl --request GET \
  --url 'https://dusic.fizvlad.com/api/v2/audios?manager=vk&type=auto&query=vk.com%2Fmusic%2Fplaylist%2F172649847_284_5a473b5c0512ace4a3' \
  --header 'Authorization: Bearer TOKEN_GOES_HERE'

Параметры

• manager: источник аудио (пока только vk)
• type: тип запроса (auto, playlist, audios, post, find, wall, artist)
• query: непосредственно запрос - ссылка на что-нибудь (помните про экранирование), либо строка для поиска

Ответ

Всегда в формате JSON. Для запроса выше примерно такое (количество аудио сокращено до одного):

{
  "request_type": "playlist",
  "response": [
    {
      "audios": [
        {
          "artist": "Радио Маяк",
          "duration": 16,
          "id": "172649847_456248185_ba4016ea89da65be0e_ba4016ea89da65be0e",
          "manager": "vk",
          "title": "Позывные (1980 г.)"
        }
      ],
      "id": "172649847_284_5a473b5c0512ace4a3",
      "manager": "vk",
      "title": "#mashup: sorted [42] - Александр Романов"
    }
  ]
}

Пример ответа только с аудио:

{
  "request_type": "artist",
  "response": [
    {
      "artist": "De Ambassade",
      "duration": 221,
      "id": "-2001858735_54858735_49e4a3d6ed251c0927_49e4a3d6ed251c0927",
      "manager": "vk",
      "title": "Geen Genade"
    },
    {
      "artist": "De Ambassade",
      "duration": 247,
      "id": "-2001634055_39634055_796e53d65daa665c53_796e53d65daa665c53",
      "manager": "vk",
      "title": "Verloren"
    }
  ]
}

Поля ответа

• request_type - строка - автоматически определённый тип запроса
• response - массив сущностей - основная часть ответа сервера

Скачивание аудио

Запрос

Путь формируется следующим образом: api/v2/audios/MANAGER/AUDIO_ID

curl --request GET \
  --url 'https://dusic.fizvlad.com/api/v2/audios/vk/172649847_456248185_fb75a2a56d5497a242_fb75a2a56d5497a242?format=mp3' \
  --header 'Authorization: Bearer TOKEN_GOES_HERE'

Параметры

• format - формат аудио, лучше использовать mp3

Ответ

Бинарный файл