对外 id 统一为两字母短码,与既有的 kw/kg/tx/wy/qs/xm/me/qt/lr 对齐; migu 与 apple 保持原样(Apple Music 没有自然的短码)。 **破坏性变更**:id 出现在所有 URL、/sources 返回、OpenAPI 示例以及 data/auth.json 的凭据键里,这四个平台已存的登录态会失效,需重新登录。 - sdk/index.ts:id 与 supportQuality 映射键 - sdk/types.ts:Source 联合类型 - src/routes.ts 与 routes-login.ts:路由路径与 schema 描述 (/login/bili/qr → /login/bl/qr 等)、/login/status 的响应键 - test/smoke-test.ts、README.md、docs/API.md 同步 有意未改:sdk 目录与文件名仍用平台名(sdk/qian/、sdk/apis/joox.ts …), 规则定为「目录=平台名,id=对外短码」,映射只在 SUPPORTED_SOURCES 一处声明。 域名与正则(joox.com、5sing.kugou.com、/joox\.com\//)、jooxSign 等标识符、 错误文案里的中文平台名、以及 kg 榜单名(含「joox本地热歌榜」)全部保持原样—— 它们只是恰好含平台名,并不是 id。 验证:typecheck ✓、pnpm test 112/112 ✓;另起临时实例实证 /sources 与 /login/status 的新 id 与展示名,新旧 id 均无残留。
43 lines
1.6 KiB
TypeScript
43 lines
1.6 KiB
TypeScript
// JOOX 搜索(上游 joox/song.go Search 移植)
|
||
// 端点:GET https://cache.api.joox.com/openjoox/v3/search?country=sg&lang=zh_cn&keyword=<kw>
|
||
// 返回 section_list(0 歌曲 / 2 歌手 / 1 专辑 / 3 歌单 / 7 用户),歌曲在 item_list[].song[].song_info。
|
||
// 该接口无分页参数(上游也未分页),page 参数仅为统一契约保留;allPage 恒为 1。
|
||
// 实测(2026-10-02):英文/中文关键词均 HTTP 200。
|
||
|
||
import { httpFetch } from '../request.ts'
|
||
import { jooxHeaders } from './util.ts'
|
||
import { jooxSongFromSearch } from './song.ts'
|
||
|
||
const SEARCH_URL = 'https://cache.api.joox.com/openjoox/v3/search'
|
||
|
||
export const search = async(keyword: string, page = 1, limit = 20) => {
|
||
const url = `${SEARCH_URL}?country=sg&lang=zh_cn&keyword=${encodeURIComponent(String(keyword ?? ''))}`
|
||
const { statusCode, body } = await httpFetch(url, { headers: jooxHeaders(), timeout: 20000 }).promise as any
|
||
if (statusCode != 200 || !body?.section_list) {
|
||
return { list: [], allPage: 0, total: 0, limit, source: 'jx' as const }
|
||
}
|
||
|
||
const list: any[] = []
|
||
const seen = new Set<string>()
|
||
for (const section of body.section_list) {
|
||
for (const item of section?.item_list ?? []) {
|
||
for (const entry of item?.song ?? []) {
|
||
const song = jooxSongFromSearch(entry?.song_info)
|
||
if (!song || seen.has(song.songmid)) continue
|
||
seen.add(song.songmid)
|
||
list.push(song)
|
||
}
|
||
}
|
||
}
|
||
|
||
return {
|
||
list: list.slice(0, limit),
|
||
allPage: 1,
|
||
total: list.length,
|
||
limit,
|
||
source: 'jx' as const,
|
||
}
|
||
}
|
||
|
||
export default { search }
|