SodaMusic-Header-Sign
汽水音乐签名
接口信息
POST
api.vsaa.cn/api/music/soda/sign.php
Method
POST
分类
迅捷如风
Calls
54
KEY
KEY 必填
计费
1 积分 / 次
QPM
60/MIN
鉴权方式
Query 参数、Header(X-API-Key)、Bearer Token
作者
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| url | string | 是 | 待签名的业务请求完整 URL(含 _rticket 等参数) | |
| body_b64 | string | 是 | 业务请求体的 Base64 编码 | |
| instance | string | 否 | 设备实例名,默认 qishui-8478-android20 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "url",
"type": "string",
"required": true,
"description": "待签名的业务请求完整 URL(含 _rticket 等参数)",
"example": ""
},
{
"name": "body_b64",
"type": "string",
"required": true,
"description": "业务请求体的 Base64 编码",
"example": ""
},
{
"name": "instance",
"type": "string",
"required": false,
"description": "设备实例名,默认 qishui-8478-android20",
"example": ""
}
]
返回示例
{
"headers": {
"X-Khronos": "1788216291",
"X-SS-STUB": "2EC719E2A65CDCA94B7B97242F4CDFBE",
"X-Argus": "4wOWag==",
"X-Gorgon": "840490d6040447f22f9ce9baca354bff48e755789c4f106a20df",
"X-Helios": "lY1mesqR2DiFP8H0yGJUHg8dlVqsSpzxhI3zffkMTv7Q3Bbt",
"X-Ladon": "eFgmfw==",
"X-Medusa": "5gOWas5I2aCqdpsp3LY4RsFuWjxsZQABodFkDZ5sgdkFGLjiatGKNN7AJY+T5FGQ6Mav1H9AT5mLW8BZuuyW/JFnZGI0y3Wpo2oTkj1gCPvFUHEv7/2TSkvhRqXnoXTXyS2Rn1zJBxMn0fIWP1+N3s2xS/xYLNtWwDxyUIsPJbY6qqRPJqGTJ54QnRjtLxqnHkYHF/mD7bzpYGF7n5btj8SOy1AaT7xbIOzZvOtKnlC60Xhei3KCKN864SBRvO6mEH+VJgW6ovWAoEupTOm6+wPKK76n7WlwHoxrT4iyObRWabFSyw0vX1fwcvcUeb+SvAh+nhAvuTGcHaZWa6QwEUALkrZEWFdggbZvHbA4Ab73MV3PaPzPPEJst2yYRkuKS+5HP3JT6I9YcLEyXCaEpKzghdJq4rHRUkURk2PuSg5agnDhH40tSwvGdv6a2s3vjznw/fycqethJoVxGT4S5ImxnAPjtsR+69w7cLDlJZYLc7kKwwnFWYN+6gJY5uOsihDx557+OplbCX4qjwZLWuuimabn2NSIxOBt3j1jOeqJBth53DFR7wujbl7sTXOfexJrtEQrSoHLm24gZIZswI/ixGBTVoOlh5NGaBBA/kjkveRcC7hc55aurjAqMX9E52edTlMscNJ83NiGYtkobGZFOI0Ltgxa5MN+lu4IXYZqYaQQB/1QVZe2ylszDL2Hue6dDrK7L3jAJHPIZDj3u+ozRZs5tcmFehnf9fv/fQtDNijLXnBDPKTYBHfwAU/VACp5jNmfy0eS5VaDcuwEd+pJHSGcmHjN1z5+abhnw+ZDDlsog0RmpUXPY36Rr/MLerQtvQAQGZvtEA3uoGKcVqyvN7ai8Ezhm42n7i7m09vpwwcbjzdH6UBIVwO9SgsHUz5r6cn3qoE48WgO84DUG/9Psgbl15wMkRuxaZc7veFVFB1a5vRhtVbvpj6/RSY3jzjPOR1ewIZ/tpJMIDhS/6ubFT9sfJCe3YXGPwObM+5yMCiu6edYwf43JKCOzPC1/+sxsGPL1vOQrkF4W/eVJ3vQ9QHECOOPbDK90xbcpIkt/fqqLCgzFG229ZPLuVS1DBo+qG+gOGFZDFkrUG3MNI92gga6tSsmgftHOKAox1sCh6KljPEzKPl803iaqm6EVNvF5sRBxIgjRSgAA1WyKFYtpkS7Sf1ZQnbrQTu/mPp3D//6dw//sUQ="
},
"diagnostics": {
"khronos": 1788216291,
"khronosSource": "url_rticket",
"reportVersion": "20.8.0",
"reportVersionSource": "url_version_name",
"bodyLength": 543,
"bodySha256": "83887202239fe76cc2053bb67aaadbb0403e93090c3cdc740ee0897f89934206",
"record52Sha256": "3cf67ae3983ed37e65c49d6b4fade03b143f74689382c3e75ac0760b7e1e9bb1",
"selector": 1,
"profile": "112280",
"fixtureVersion": "medusa-low20-selectors-v20.6-parity/v1",
"algorithmVersion": "qishui-sign-node/v1"
}
}
详细文档
SodaMusic-Header-Sign
接口说明
汽水音乐签名接口,用于为业务请求生成所需的请求头签名(如 X-Khronos、X-Gorgon 等)。面向需要构造合法音乐业务请求的开发者调用。
调用地址
POST /api/music/soda/sign.php
请求方式
POST
请求参数以 JSON 形式编码在请求体中。
鉴权说明
本接口为收费接口,必须在 Query 中提供 key 参数。每次调用时请将接口调用密钥作为 key 拼接至请求 URL 查询字符串,格式为 ?key=your_key。密钥错误或缺失时将返回未授权响应。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥,通过 Query 参数传递 |
| url | string | 是 | 待签名的业务请求完整 URL(含 _rticket 等参数) |
| body_b64 | string | 是 | 业务请求体的 Base64 编码 |
| instance | string | 否 | 设备实例名,默认 qishui-8478-android20 |
成功响应示例
{
"headers": {
"X-Khronos": "1788216291",
"X-SS-STUB": "2EC719E2A65CDCA94B7B97242F4CDFBE",
"X-Argus": "4wOWag==",
"X-Gorgon": "840490d6040447f22f9ce9baca354bff48e755789c4f106a20df",
"X-Helios": "lY1mesqR2DiFP8H0yGJUHg8dlVqsSpzxhI3zffkMTv7Q3Bbt",
"X-Ladon": "eFgmfw==",
"X-Medusa": "5gOWas5I2aCqdpsp3LY4RsFuWjxsZQABodFkDZ5sgdkFGLjiatGKNN7AJY+T5FGQ6Mav1H9AT5mLW8BZuuyW/JFnZGI0y3Wpo2oTkj1gCPvFUHEv7/2TSkvhRqXnoXTXyS2Rn1zJBxMn0fIWP1+N3s2xS/xYLNtWwDxyUIsPJbY6qqRPJqGTJ54QnRjtLxqnHkYHF/mD7bzpYGF7n5btj8SOy1AaT7xbIOzZvOtKnlC60Xhei3KCKN864SBRvO6mEH+VJgW6ovWAoEupTOm6+wPKK76n7WlwHoxrT4iyObRWabFSyw0vX1fwcvcUeb+SvAh+nhAvuTGcHaZWa6QwEUALkrZEWFdggbZvHbA4Ab73MV3PaPzPPEJst2yYRkuKS+5HP3JT6I9YcLEyXCaEpKzghdJq4rHRUkURk2PuSg5agnDhH40tSwvGdv6a2s3vjznw/fycqethJoVxGT4S5ImxnAPjtsR+69w7cLDlJZYLc7kKwwnFWYN+6gJY5uOsihDx557+OplbCX4qjwZLWuuimabn2NSIxOBt3j1jOeqJBth53DFR7wujbl7sTXOfexJrtEQrSoHLm24gZIZswI/ixGBTVoOlh5NGaBBA/kjkveRcC7hc55aurjAqMX9E52edTlMscNJ83NiGYtkobGZFOI0Ltgxa5MN+lu4IXYZqYaQQB/1QVZe2ylszDL2Hue6dDrK7L3jAJHPIZDj3u+ozRZs5tcmFehnf9fv/fQtDNijLXnBDPKTYBHfwAU/VACp5jNmfy0eS5VaDcuwEd+pJHSGcmHjN1z5+abhnw+ZDDlsog0RmpUXPY36Rr/MLerQtvQAQGZvtEA3uoGKcVqyvN7ai8Ezhm42n7i7m09vpwwcbjzdH6UBIVwO9SgsHUz5r6cn3qoE48WgO84DUG/9Psgbl15wMkRuxaZc7veFVFB1a5vRhtVbvpj6/RSY3jzjPOR1ewIZ/tpJMIDhS/6ubFT9sfJCe3YXGPwObM+5yMCiu6edYwf43JKCOzPC1/+sxsGPL1vOQrkF4W/eVJ3vQ9QHECOOPbDK90xbcpIkt/fqqLCgzFG229ZPLuVS1DBo+qG+gOGFZDFkrUG3MNI92gga6tSsmgftHOKAox1sCh6KljPEzKPl803iaqm6EVNvF5sRBxIgjRSgAA1WyKFYtpkS7Sf1ZQnbrQTu/mPp3D//6dw//sUQ="
},
"diagnostics": {
"khronos": 1788216291,
"khronosSource": "url_rticket",
"reportVersion": "20.8.0",
"reportVersionSource": "url_version_name",
"bodyLength": 543,
"bodySha256": "83887202239fe76cc2053bb67aaadbb0403e93090c3cdc740ee0897f89934206
## 错误响应示例
```json
{"code":0,"msg":"未提供调用密钥","errcode":11001}
业务错误码说明
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
调用示例
终端 curl(bash)
curl -X POST "https://api.example.com/api/music/soda/sign.php?key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.example.com/api/music/playlist?_rticket=1788216291",
"body_b64": "eyJuYW1lIjoi5a2X55Cm5pWwIiwidHlwZSI6InBsYXlsaXN0In0=",
"instance": "qishui-8478-android20"
}'
PHP
## 注意事项
- 本接口为收费接口,每次调用均计费,请合理安排调用频次。
- 密钥通过 Query 参数 `key` 传递,请勿将密钥写入前端代码或公开仓库,避免泄露导致盗用。
- 请求地址使用 HTTPS 协议,确保传输安全。
- 参数 `body_b64` 需为业务请求体的 Base64 编码,编码前确保 body 为原始字节流,不含额外换行或空格。
- 参数 `url` 必须包含完整的业务请求 URL,包括 `_rticket`、`_did` 等业务签名参数,缺失会导致签名计算失败。
- 频率限制约为每分钟 60 次,超限将触发限流,请控制调用节奏。
- `instance` 参数为设备实例名,不传时使用默认值 `qishui-8478-android20`,如需指定设备指纹可传入对应实例标识。
- 返回的签名头部(如 `X-Gorgon`、`X-Argus` 等)具有时效性,建议在业务请求前即时生成,避免缓存复用。快速上手
curl -X POST 'https://api.ishx.cn/api/music/soda/sign.php?key=YOUR_API_KEY' \
-d 'url=https://www.douyin.com/&body_b64=aGVsbG8='
在线测试
请求地址
api.vsaa.cn/api/music/soda/sign.php
参数
Response
等待中
// 结果将在此处显示