歌单导入 - 元数据/文字/链接导入
登录后调用此接口, 支持通过元数据/文字/链接三种方式生成歌单; 三种方式不可同时调用
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | /playlist/import/name/task/create |
| 请求方式 | GET / POST |
| 需要登录 | 是 |
| 对应模块 | playlist_import_name_task_create |
| 文档分类 | 歌单 |
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
importStarPlaylist | boolean | — | - | 是否导入我喜欢的音乐, 此项为true则不生成新的歌单 |
playlistName | string | — | 为 | 生成的歌单名, 仅文字导入和链接导入支持, 默认为'导入音乐 '.concat(new Date().toLocaleString()) |
HTTP 示例
bash
GET /playlist/import/name/task/create?local=${local}编程式调用
ts
import { playlistImportNameTaskCreate } from 'hana-music-api'
const result = await playlistImportNameTaskCreate({
local: '${local}',
})
console.log(result.body)补充说明
说明 : 登录后调用此接口, 支持通过元数据/文字/链接三种方式生成歌单; 三种方式不可同时调用
接口地址 : /playlist/import/name/task/create
可选参数 :
importStarPlaylist : 是否导入我喜欢的音乐, 此项为true则不生成新的歌单 playlistName : 生成的歌单名, 仅文字导入和链接导入支持, 默认为'导入音乐 '.concat(new Date().toLocaleString())
元数据导入 :
local: json类型的字符串, 如:
javascript
let local = encodeURIComponent(
JSON.stringify([
{
name: 'アイニーブルー', // 歌曲名称
artist: 'ZLMS', // 艺术家名称
album: 'アイニーブルー', // 专辑名称
},
{
name: 'ファンタズマ',
artist: 'sasakure.UK',
album: '未来イヴ',
},
]),
)调用例子 : /playlist/import/name/task/create?local=${local}
文字导入 :
text: 导入的文字, 如:
javascript
let text = encodeURIComponent(`アイニーブルー ZLMS
ファンタズマ sasakure.UK`)调用例子 : /playlist/import/name/task/create?text=${text}
链接导入 :
link: 存有歌单链接的数组类型的字符串, 如:
javascript
let link = encodeURIComponent(
JSON.stringify([
'https://i.y.qq.com/n2/m/share/details/taoge.html?id=7716341988&hosteuin=',
'https://i.y.qq.com/n2/m/share/details/taoge.html?id=8010042041&hosteuin=',
]),
)歌单链接来源:
- 将歌单分享到微信/微博/QQ后复制链接
- 直接复制歌单/个人主页链接
- 直接复制文章链接
调用例子 : /playlist/import/name/task/create?link=${link}