API 文档

电音基调查询库 · KEY & BPM 数据库开放接口。基础地址：https://www.a.core2vst.com

0. 概述

1. 通用返回与错误码

所有接口返回统一的 JSON 结构：

{
  "code": 200,
  "data": { ... },
  "msg": "success"
}

data 中所有字段值均为字符串类型。

2. 搜索接口公开

GET /music/search —— 按歌名 / 歌手检索，返回匹配的 KEY、大小调等信息（分页）。

请求参数

请求示例

GET /music/search?q=Faded&type=all&quality=all&page=1&size=2

命中返回（code=200）

{
  "code": 200,
  "data": {
    "total": "384",
    "page": "1",
    "size": "2",
    "items": [
      {"id":"150473","song":"7爷、Faded、浪子康、扎职 - Gangsta Walk (DJ版)","code":"0","basic":"Ab","basic_t":"273","scale":"小调","recog":"n","recog_link":""}
    ]
  },
  "msg": "success"
}

未命中返回（code=301）

{"code":301,"data":{"total":"0","page":"1","size":"20","items":[]},"msg":"未命中"}

排序：官方 (official) → 用户 (user) → 已失效 (dead)，同级按歌名升序。

3. 统计接口公开

GET /music/stats —— 返回数据库中按质量分类的记录总数。

GET /music/stats

{
  "code": 200,
  "data": {"total":"803146","official":"114221","user":"390384","dead":"298541"},
  "msg": "success"
}

4. 登录接口公开

POST /music/login —— 获取访问 Token。支持两种协议，二选一：

方式 A（推荐，客户端已登录会员时）：user_token + machine_code

POST /music/login
Content-Type: application/x-www-form-urlencoded

user_token=xxxx&machine_code=yyyy

方式 B（账号密码）：account + password

POST /music/login
Content-Type: application/x-www-form-urlencoded

account=your_account&password=your_password

常见返回

5. 签名规则（RSA）

鉴权接口（lookup / feedback）需要 RSA 签名，规则如下：

签名字符串

act=<act>&t=<t>#<JSON字符串>

其中 <act> 为动作名，<t> 为当前时间戳（秒），<JSON字符串> 为 POST body 中 D 参数的原始 JSON（未 urlencode 之前）。

请求格式

POST /music/lookup?act=lookup&t=<时间戳>&sign=<Base64签名>
Content-Type: application/x-www-form-urlencoded

D=<urlencode(JSON)>

6. 基调查询接口需签名

POST /music/lookup —— 按歌名精确查询单首歌曲（大小写不敏感，不做模糊匹配）。

URL 参数

POST Body

JSON 字段：token（登录返回的 Token）、song（歌名，最长 200 字符）。

请求示例

POST /music/lookup?act=lookup&t=1725446400&sign=abc123...
Content-Type: application/x-www-form-urlencoded

D=%7B%22token%22%3A%22xxx%22%2C%22song%22%3A%22Faded%22%7D

返回

// 命中
{"code":200,"data":{...单条记录...},"msg":"success"}

// 未命中
{"code":301,"data":null,"msg":"未命中"}

// 参数缺失
{"code":400,"data":null,"msg":"缺少参数 act / t / sign"}

7. data 字段说明

8. 完整调用示例

cURL

curl "https://www.a.core2vst.com/music/search?q=Faded&type=all&page=1&size=20"

cURL（搜索接口，无需鉴权）

curl "https://www.a.core2vst.com/music/search?q=Faded&type=all&page=1&size=20"

Python（登录 → 签名 → 查询 完整流程）

import requests, time, json, urllib.parse
from cryptography.hazmat.primitives import hashes, serialization
from cryptography.hazmat.primitives.asymmetric import padding

BASE = "https://www.a.core2vst.com"
PRIV = serialization.load_pem_private_key(open("client_private_key.pem","rb").read(), None)

# ① 登录取 Token
r = requests.post(BASE + "/music/login",
                  data={"account": "your_account", "password": "your_password"}).json()
token = r["data"]["token"]

# ② 构造业务 JSON 并签名
payload = json.dumps({"token": token, "song": "Faded"}, separators=(",", ":"))
t = str(int(time.time()))
sign_str = "act=lookup&t=" + t + "#" + payload
sign = base64.b64encode(PRIV.sign(sign_str.encode(), padding.PKCS1v15(), hashes.SHA256())).decode()

# ③ 查询
r2 = requests.post(BASE + "/music/lookup?act=lookup&t=" + t + "&sign=" + sign,
                   data={"D": urllib.parse.quote(payload)}).json()
if r2["code"] == 200:
    print("调性：", r2["data"]["basic"], r2["data"]["scale"])
else:
    print("失败：", r2["code"], r2["msg"])

PHP

<?php
$base = "https://www.a.core2vst.com";
// ① 登录
$login = json_decode(file_get_contents($base . "/music/login", false,
    stream_context_create(["http" => ["method" => "POST", "header" => "Content-Type: application/x-www-form-urlencoded",
    "content" => http_build_query(["account" => "your_account", "password" => "your_password"])]])), true);
$token = $login["data"]["token"];

// ② 签名（私钥文件 client_private_key.pem）
$payload = json_encode(["token" => $token, "song" => "Faded"]);
$t = time();
openssl_sign("act=lookup&t=" . $t . "#" . $payload, $sign, file_get_contents("client_private_key.pem"), OPENSSL_ALGO_SHA256);
$sign = base64_encode($sign);

// ③ 查询
$ch = curl_init($base . "/music/lookup?act=lookup&t=" . $t . "&sign=" . urlencode($sign));
curl_setopt_array($ch, [CURLOPT_POST => 1, CURLOPT_POSTFIELDS => ["D" => urlencode($payload)], CURLOPT_RETURNTRANSFER => 1]);
$r = json_decode(curl_exec($ch), true);
if ($r["code"] == 200) { echo $r["data"]["basic"], " ", $r["data"]["scale"]; }