✨ 新功能: - 创建bilibili_audio_downloader_pro.py (Pro版) - 全新架构重构 - 添加config.json配置文件支持 - 新增INSTALL.md详细安装指南 - 新增VERSION_COMPARISON.md版本对比说明 🐛 Bug修复 (v14.0): - 修复中文编码显示问题 - 修复ffmpeg进度条计算不准确 - 改进yt-dlp下载进度解析 - 添加重试机制和超时设置 - 完善错误处理和日志记录 🏗️ Pro版优势: - 面向对象架构设计,代码更清晰 - 自定义异常类和智能错误恢复 - 准确的进度条显示算法 - 完整的日志系统 - 灵活的配置管理 - 更好的用户体验 📚 文档更新: - 更新README.md,添加版本对比指引 - 更新requirements.txt依赖列表 - 完善项目文档结构
2.6 KiB
2.6 KiB
客服消息
心跳
https://customerservice.bilibili.com/x/custom/session_svr/v1/heart_beat
请求方式: GET
认证方式: Cookie (SESSDATA)
URL参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| shop_id | num | 0 | 非必要 | |
| shop_father_id | num | 0 | 非必要 | |
| build | num | 客户端版本 | 非必要 | web: 0 |
| mobi_app | str | 客户端类型 | 非必要 | 如 web |
JSON回复:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0: 成功 |
| msg | str | ok |
失败时不存在 |
| message | str | 错误信息 | 成功时为 ok |
| ttl | num | 1 |
示例:
curl -G "https://customerservice.bilibili.com/x/custom/session_svr/v1/heart_beat" \
-b "SESSDATA=xxx"
查看响应示例:
{
"code": 0,
"msg": "ok",
"message": "ok",
"ttl": 1
}
上传文件
https://customerservice.bilibili.com/x/custom/msg_svr/v1/upload
请求方式: POST
认证方式: Cookie (SESSDATA)
注: 上传的文件 15 分钟内有效, 过期后下载会返回 HTTP 403
正文参数 (multipart/form-data):
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| file | file | 文件内容 | 必要 | |
| filename | str | 文件名 | 必要 | |
| mid | num | 用户 mid | 必要 | |
| csrf | str | CSRF Token (位于 Cookie 中 bili_jct) | 必要 |
JSON回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0: 成功 1000011: 仅支持上传300M内的文件 1200201: 获取用户信息失败 |
| message | str | 错误信息 | 成功时为 ok |
| ttl | num | 1 | |
| data | obj | 上传结果 |
data 对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| key | str | 文件名 | |
| url | str | 文件 URL | 注意转义 |
示例:
上传文件 ./headers/xx-out.xcf, 文件名 ihavenoname
curl -X POST "https://customerservice.bilibili.com/x/custom/msg_svr/v1/upload" \
-F 'file=@./headers/xx-out.xcf' \
-F 'filename=ihavenoname' \
-F 'mid=1070915568' \
-F 'csrf=xxx' \
-b 'SESSDATA=xxx; bili_jct=xxx'
查看响应示例:
{
"code": 0,
"message": "ok",
"ttl": 1,
"data": {
"key": "1a0c88d240852155a111e4cc6893be39.xcf",
"url": "https://jssz-boss.hdslb.com/customer-video-upload/1a0c88d240852155a111e4cc6893be39.xcf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=f9TxwsagojnE1DWM%2F20240803%2Fjssz%2Fs3%2Faws4_request&X-Amz-Date=20240803T115447Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=cef962c8e503c6ff564fd485bdef1079df1b4a7e38f4fbd9c21a5667207f406e"
}
}