Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия NetEase Cloud Music: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Музыкальные чартыtoplist | Получите треки из чартов NetEase Cloud Music. | $0.56 за 1 000 запросов | Норма |
Плейлистplaylist | Получите треки плейлиста NetEase Cloud Music по порядку, по playlist_id или ссылке. | $0.56 за 1 000 запросов | Норма |
Комментарииcomments | Получите комментарии к песне в NetEase Cloud Music по song_id или ссылке на песню: лайки, число ответов, флаги популярных комментариев и родительский комментарий для каждого ответа. | $0.56 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API NetEase Cloud Music?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
toplistМузыкальные чарты Получите треки из чартов NetEase Cloud Music. У каждого трека есть позиция, исполнители, альбом, длительность и показатель популярности, а также название, число прослушиваний и время последнего обновления самого чарта. | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | rank · track_id · track_name · track_alias · duration_ms · artists · artist_ids · album_id · album_name · album_cover_url · published_at · is_explicit · popularity_score · track_url · playlist_id · playlist_name · playlist_type · playlist_cover_url · playlist_track_count · playlist_play_count · playlist_subscribed_count · playlist_updated_at · snapshotted_at · platform | |
playlistПлейлист Получите треки плейлиста NetEase Cloud Music по порядку, по | playlist_id | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | rank · track_id · track_name · track_alias · duration_ms · artists · artist_ids · album_id · album_name · album_cover_url · published_at · is_explicit · popularity_score · track_url · playlist_id · playlist_name · playlist_type · playlist_cover_url · playlist_track_count · playlist_play_count · playlist_subscribed_count · playlist_updated_at · snapshotted_at · platform |
commentsКомментарии Получите комментарии к песне в NetEase Cloud Music по | song_id | sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=50, maxLimit=1000. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 1000. | $0.56 за 1 000 запросов | id · song_id · song_name · url · text · like_count · reply_count · is_hot · is_reply · parent_comment_id · author_name · author_avatar_url · posted_at · platform |
Что означают параметры действия toplist в API NetEase Cloud Music?
Получите треки из чартов NetEase Cloud Music. У каждого трека есть позиция, исполнители, альбом, длительность и показатель популярности, а также название, число прослушиваний и время последнего обновления самого чарта. popularity_score принимает значения от 0 до 100 и не является числом прослушиваний. rank относится только к текущему снимку.
У этого действия нет бизнес-параметров. Передайте только идентификаторы платформы и действия.
Что означают параметры действия playlist в API NetEase Cloud Music?
Получите треки плейлиста NetEase Cloud Music по порядку, по playlist_id или ссылке. Для каждого трека указаны исполнители, альбом, длительность и дата выхода. Длительность указана в миллисекундах, а трек из списка не обязательно доступен для прослушивания во всех регионах.
playlist_idОбязательный- ID плейлиста NetEase Cloud Music для действия playlist. Принимает числовой ID плейлиста или URL, содержащий playlist?id= или /playlist/ID. Этот параметр отличается от ID песен, и действие toplist его не использует.NetEase Cloud Music: контейнеры чартов и внутренние ссылки на песни — Официальная страница чартов NetEase Cloud Music отделяет чарты от списков песен, и у каждого трека есть собственная ссылка `song?id=`. Здесь `playlist_id` указывает на плейлист или контейнер чарта, а `song_id` идентифицирует трек; страница чартов не означает полного охвата данных через API или их актуальности в реальном времени. · Проверено
Что означают параметры действия comments в API NetEase Cloud Music?
Получите комментарии к песне в NetEase Cloud Music по song_id или ссылке на песню: лайки, число ответов, флаги популярных комментариев и родительский комментарий для каждого ответа. Сортировка: hot (по умолчанию), recommend или time. Закреплённые комментарии могут появиться при любой сортировке.
song_idОбязательный- ID трека NetEase Cloud Music для действия comments. Принимает числовой ID песни или URL, содержащий song?id= или /song/ID. Передать ID плейлиста вместо ID песни нельзя.NetEase Cloud Music: комментарии нужно запрашивать для песен, а не для чартов — Списки песен в официальных чартах ведут на страницы соответствующих песен, что подтверждает: песни и чарты являются разными объектами. Этот источник не описывает сортировку комментариев и то, какие ответы возвращаются: это определяется параметрами, указанными выше. · Проверено
sortНеобязательный- Сортирует комментарии к треку в действии comments. Поддерживаемые значения: hot (по умолчанию), recommend и time. Псевдонимы совместимости latest и new соответствуют сортировке time. Значение newest не поддерживается, вместо него применяется hot. Закреплённые комментарии могут появляться в результатах при любой сортировке.
Как использовать API NetEase Cloud Music
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"netease_music","action":"toplist","params":{}}'
Вопросы об API NetEase Cloud Music
Какие данные можно получить через API NetEase Cloud Music?
Укажите в platform значение netease_music. В текущем каталоге: музыкальные чарты, плейлист и комментарии. Эти названия действий соответствуют разным объектам или представлениям NetEase Cloud Music; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса toplist к платформе NetEase Cloud Music?
У действия toplist нет собственных обязательных параметров. Передайте идентификаторы платформы и действия, а также только те необязательные параметры, которые вам нужны.
Какие поля может вернуть toplist на платформе NetEase Cloud Music?
Объявленная схема включает rank, track_id, track_name и track_alias. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия NetEase Cloud Music возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.