BYDOTA粉丝玩车俱乐部 · 开放平台 curl 调用速查 ==================================================== 使用方法：把下面命令中的 YOUR_API_KEY 替换为你的密钥（开放平台页面申请）， 密钥放在请求头 Authorization: Bearer 后面，或使用 X-API-Key 请求头。 接口文档与在线申请：https://pan.zoroli.com/openapi ---------------------------------------------------- 0. 目录结构速览（先读这个，理解 id 的含义） ---------------------------------------------------- 根目录下是 7 个品牌分区：01王朝、02海洋、03腾势、04方程豹、05仰望、06领汇、07其他。 id 以 v: 开头的是平台分类/规整节点，id 固定不变： v:b:品牌 品牌分区（如 v:b:王朝） v:s:品牌/车系 车系（如 v:s:王朝/汉） v:m:品牌/车系/车型 已规整车型目录（该车型下同名文件夹已合并、 同名同大小文件只保留一份） v:r:...:数字id 跨车型共享内容的展示条目（同一文件在多个车型下 各有一个 id，末位数字为真实文件 id；可直接用于下载换链） 其余 id 为纯数字，是源站原始目录/文件，恒定不变。 车型目录规整分批进行中：已规整车系下是合并后的车型目录，未规整车系下仍是原始文件夹。 文件夹的「更新时间」= 内部最新文件的更新时间（与网站显示一致），可直接使用。 ---------------------------------------------------- 1. 目录概览（文件夹 / 文件数量、最近同步时间；按发布目录树口径统计） ---------------------------------------------------- curl -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/stats" ---------------------------------------------------- 2. 目录列表（根目录第一页，每页 20 条，按时间倒序） ---------------------------------------------------- curl -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/list?fid=root&page=1&size=20" # 浏览子文件夹：把上一条返回的 items[].id（folder=true 的）作为 fid curl -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/list?fid=26843956350624" # 按名称升序、每页 50 条 curl -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/list?fid=root&sort=name&asc=1&size=50" ---------------------------------------------------- 3. 搜索（关键词需 URL 编码；「海狮」编码为 %E6%B5%B7%E7%8B%AE） ---------------------------------------------------- curl -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/search?q=%E6%B5%B7%E7%8B%AE&limit=5" # 跨车型共享的内容会在多个车型目录下各命中一次（id 不同、指向同一文件）， # 用任一 id 换取下载短链均可。 ---------------------------------------------------- 4. 完整目录树（保存到本地文件 tree.json） ---------------------------------------------------- curl --compressed -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/tree" -o tree.json ---------------------------------------------------- 5. 换取文件下载短链（本站 /d/ 短链，约 30 分钟有效，过期请重新调用） ---------------------------------------------------- # 返回 JSON：data.url 即下载短链（最终用户打开即可下载，免登录） curl -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/download?fid=25349200221377" # 共享条目（v:r: 开头的 id）同样可以直接换取： curl -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/download?fid=v:r:仰望/U8/2025款U8:26844438146832" # 直接 302 跳转下载（-L 跟随跳转即可保存文件） curl -L -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/download?fid=25349200221377&redirect=1" -o 12个程序更新.rar ---------------------------------------------------- 6. 车架号校验（是否比亚迪品牌；无需品牌/车系/车型，纯本地判定） ---------------------------------------------------- # data.byd=true 即比亚迪（格式 + 校验位 + WMI[LC0/LGX/LPE/LA9] + 年份 全通过） curl -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/vin-check?vin=LC0C74C44M1107654" ---------------------------------------------------- 7. OTA 推送记录（全站采集沉淀，车型+版本维度；不含任何用户车架号） ---------------------------------------------------- curl -H "Authorization: Bearer YOUR_API_KEY" "https://pan.zoroli.com/open/v1/ota-records?brand=王朝&page=1&size=20" ---------------------------------------------------- 8. 账号体系（OAuth2 授权码模式，需 account 权限 + 开发者中心创建应用） ---------------------------------------------------- # ① 引导用户浏览器打开授权页（用户登录并确认后 302 回跳 code=...&state=...） # https://pan.zoroli.com/oauth/authorize?client_id=应用ID&redirect_uri=回调地址&state=随机值 # ② 服务端用授权码换 access_token（5 分钟内，一次性；client_secret 别放浏览器端）： curl -X POST "https://pan.zoroli.com/open/v1/oauth/token" \ -d "grant_type=authorization_code&code=授权码&client_id=应用ID&client_secret=应用密钥&redirect_uri=回调地址" # ③ 读用户基本资料（用户名/昵称/头像；access_token 30 天有效）： curl -H "Authorization: Bearer ACCESS_TOKEN" "https://pan.zoroli.com/open/v1/account/me" ---------------------------------------------------- 常见问题 ---------------------------------------------------- - 401 missing_api_key : 请求头没带密钥 - 401 invalid_api_key : 密钥错误或已停用 - 403 key_pending : 密钥待管理员审核 - 403 scope_denied : 密钥未授权该接口（如未授权 download 却调下载） - 429 rate_limited : 调用超限（60 次/分钟；下载换链 10 次/分钟），等响应头 retry-after 秒 - 下载短链 url 约 30 分钟过期，请勿缓存后长期使用