v1当前唯一主版本,破坏性变更只在新主版本发生
Ed25519插件包签名算法,公钥公开可验证
cursor-page/1列表端点统一分页契约
Bearerqf_live_ 前缀 API 密钥,Authorization 头传递
按你的角色挑入口
第一次接入走快速开始;已经拿到密钥的直接翻端点参考;要接事件推送的看 Webhook。
1
2
3
这一版能做什么
| 家族 | 鉴权方式 | 端点数 | 用途 |
|---|---|---|---|
| /api/v1 | Bearer API 密钥 | 14 | 账号侧数据与订单/发票/插件提交,含 Webhook 管理 |
| /api/developer | 会话 JWT | 4 | 开发者资料与插件提交管理 |
| /api/shared-index | 会话 + 团队 | 4 | 团队共享索引(测试版) |
| /api/signing-keys | 公开 | 2 | 插件包签名公钥与验签 |
关于本地文件
本版本不提供读取用户本地文件的能力——文件索引只留在本机,接口只碰云端数据。这是刻意的产品边界,不会「以后开放」。