Я подобрал музыку 😂😂😂

внешний интерфейс

Обновленные статьи, пожалуйста, двигайтесьЯ подобрал музыку 😂😂😂 V2.0

Кушать хот-пот, писать код, слушать песни... Случайно попала в список определенная музыкальная композиция, воспользовавшись энтузиазмом, я подобрал набор api (минималистичный, удобный, от получения чартов до url воспроизведения песни). Поделись документацией по интерфейсу. Всем веселья. 😄

2018-12-24-22-58-59

Адрес этого проектаgithub

доменное имя интерфейса

music.niubishanshan.top

basePath

/api/music

1. Получите информацию о рекомендациях на главной странице

1.1 Функциональное описание

Получайте рекомендуемую информацию на главной странице веб-сайта, включая популярные карусели и трансляции.

1.2 Описание запроса

Описание запроса:
Метод запроса GET
URL-адрес запроса:/recommend

1.3 Параметры запроса

поле Тип поля Поле Описание
без без без

1.4 Вернуть результат

{
    "errno": 0,
    "msg": "success",
    "data": {
        "slider": [
            "http://y.gtimg.cn/music/common/upload/MUSIC_FOCUS/1111137.jpg",
            "http://y.gtimg.cn/music/common/upload/MUSIC_FOCUS/1109397.jpg",
            "http://y.gtimg.cn/music/common/upload/MUSIC_FOCUS/1109234.jpg",
            "http://y.gtimg.cn/music/common/upload/MUSIC_FOCUS/1109139.jpg",
            "http://y.gtimg.cn/music/common/upload/MUSIC_FOCUS/1110553.jpg"
        ],
        "radioList": [
            {
                "picUrl": "http://y.gtimg.cn/music/photo/radio/track_radio_199_13_1.jpg",
                "title": "热歌",
                "id": 199
            },
            {
                "picUrl": "http://y.gtimg.cn/music/photo/radio/track_radio_307_13_1.jpg",
                "title": "一人一首招牌歌",
                "id": 307
            }
        ]
    }
}

1.5 Возвращаемые параметры

поле Тип поля Поле Описание
errno int 0: означает отсутствие проблем, другое означает наличие проблемы.
msg string Описание статуса возврата интерфейса
data object Интерфейс возвращает тело данных
  slider array Информация о карусели (вложенная запись представляет собой строку)
  radioList array Данные списка станций (всегда возвращает два)
    picUrl string логотип радиостанции
    title string название станции
    id ing идентификатор станции

1.6 Код состояния ошибки

Код надежен как корова и не сообщает об ошибках~

2. Получите информацию о таблице лидеров

2.1 Описание функций

Получите данные о рейтинге, то, что вы получите, - это ранжированная версия списка песен, полученная из различных измерений (например, еженедельный список, ежемесячный список...)

2.2 Описание запроса

Описание запроса:
Метод запроса GET
URL-адрес запроса:/toplist

2.3 Параметры запроса

поле Тип поля Поле Описание
без без без

2.4 Вернуть результат

{
    "errno": 0,
    "msg": "success",
    "data": [
        {
            "id": 4,
            "title": "巅峰榜·流行指数",
            "listenCount": 19500000,
            "picUrl": "http://y.gtimg.cn/music/photo_new/T003R300x300M000000VjrhC1PVxWS.jpg",
            "songList": [
                {
                    "singername": "薛之谦",
                    "songname": "天份",
                    "number": 1
                },
                {
                    "singername": "陈柯宇",
                    "songname": "生僻字",
                    "number": 2
                },
                {
                    "singername": "毛不易",
                    "songname": "别再闹了",
                    "number": 3
                }
            ]
        }
        ... 各种数据 ...
    ]
}

2.5 Возвращаемые параметры

поле Тип поля Поле Описание
errno int 0: означает отсутствие проблем, другое означает наличие проблемы.
msg string Описание статуса возврата интерфейса
data array Интерфейс возвращает тело данных
  id int Идентификатор одной песни
  title string название плейлиста
  listenCount int
  picUrl string Логотип плейлиста
  songList array 3 лучшие песни в чарте
    singername string имя певца
    songname string название песни
    number int ранжирование

2.6 Код состояния ошибки

Код надежен как корова и не сообщает об ошибках~

3. Получить список песен

3.1 Функциональное описание

Получить список треков в указанном плейлисте

3.2 Описание запроса

Описание запроса:
Метод запроса GET
URL-адрес запроса:/songIdlist/{:songListId}

3.3 Параметры запроса

поле Тип поля Поле Описание
songListId string Идентификатор плейлиста — это поле идентификатора записи плейлиста, полученное в таблице лидеров, которое используется для указания плейлиста, выбранного пользователем.

3.4 Возврат результата

{
    "errno": 0,
    "msg": "success",
    "data": {
        "update_time": "2018-12-24",
        "total_song_num": 100,
        "topinfo": {
            "pic_album": "http://imgcache.qq.com/music/photo_new/T002R300x300M000004KfMU92CZeAd.jpg",
            "ListName": "巅峰榜·流行指数"
        },
        "songlist": [
            {
                "songmid": "000Qepff3UyUWO",
                "singer": "薛之谦",
                "songname": "天份"
            },
           ...各种数据...
        ]
    }
}

3.5 Возвращаемые параметры

поле Тип поля Поле Описание
errno int 0: означает отсутствие проблем, другое означает наличие проблемы.
msg string Описание статуса возврата интерфейса
data object Интерфейс возвращает тело данных
  update_time string Время обновления
  total_song_num int Количество песен в плейлисте
  topinfo object Информация о плейлисте
    pic_album string Логотип обложки плейлиста
    ListName string Название плейлиста
  songlist array список песен
    songmid string идентификатор песни
    singer string имя певца
    songname string название песни

3.6 Код состояния ошибки

Код надежен как корова и не сообщает об ошибках~

4. Получите URL воспроизведения песни

4.1 Описание функций

В соответствии с идентификатором песни получите URL-адрес воспроизведения (доступен в настоящее время)

4.2 Описание запроса

Описание запроса:
Метод запроса GET
URL-адрес запроса:/songUrllist/{:songIdList}

4.3 Параметры запроса

поле Тип поля Поле Описание
songIdList stringArray Список идентификаторов песен, которые необходимо объединить вid1,id2,id3,id4форма

4.4 Вернуть результат

{
    "errno": 0,
    "msg": "success",
    "data": [
        "http://isure.stream.qqmusic.qq.com//C400000Qepff3UyUWO.m4a?guid=5579254314&vkey=70D5522DDF8F35B36B133AA0F85A9C2FA608F2FA85BCBB4EC31CC6A0047CEAB873E9E2B947A6D893C219C65781B9EFE1F00C583518290F4E&uin=0&fromtag=38",
        "http://isure.stream.qqmusic.qq.com//C400001KxFBr3ZrMIk.m4a?guid=5579254314&vkey=7DC202D78758D601A1EF4B15F5597A805C740CFCE9210870073D05247716E83D4146EE3907962645D2F7BE99071BFC0B01E73F09AFA5114D&uin=0&fromtag=38"
    ]
}

4.5 Возвращаемые параметры

поле Тип поля Поле Описание
errno int 0: означает отсутствие проблем, другое означает наличие проблемы.
msg string Описание статуса возврата интерфейса
data array Товар соответствует музыке

4.6 Код состояния ошибки

Код надежен как корова и не сообщает об ошибках~

Этот интерфейс используется только для обучения и общения, пожалуйста, не используйте его не по назначению.Тестовый сервис не делал никакой обработки, и он не выдерживает различных атак типа ddos.Надеюсь босс будет милостив.

Категории