DEVELOPER API
接口文档
程序调用使用 AK/SK 签名,Web 使用登录令牌;所有数据按账号隔离。
Web 登录态
登录接口返回的 token,放在请求头:
Authorization: Bearer <token>
默认 7 天有效,登出后立即失效。
程序调用(AK/SK)
四个请求头配合使用,SK 不出网络:
X-AK: 访问密钥 AK X-Timestamp: Unix 秒级时间戳 X-Nonce: 一次性随机串 X-Signature: HMAC-SHA256(SK, 待签字符串)
签名规则
待签字符串共 6 行,用换行连接(末尾不加换行)。查询参数按 key 升序拼接, 没有参数时该行为空;请求体为空时最后一行为空字符串的 SHA-256。
POST /api/tasks page=1&status=pending 1731300000 7d1f0c9a4b2e4f6a 9f2c1d...(请求体的 SHA-256 十六进制)
路径包含 /api 前缀;时间戳偏差超过 300 秒、nonce 重复、签名不符都会返回 401。
签名生成器
AK/SK 只在本页计算,不会发送到服务器请求头
X-AK: <AK> X-Timestamp: 1794833454 X-Nonce: 5298da8f942f10c8c62bc34418f9bbf4 X-Signature: (填写 AK / SK 后自动计算)
可直接执行的命令
curl.exe -X POST "http://127.0.0.1:8000/api/tasks" \
-H "X-AK: <AK>" \
-H "X-Timestamp: 1794833454" \
-H "X-Nonce: 5298da8f942f10c8c62bc34418f9bbf4" \
-H "X-Signature: <签名>" \
-H "Content-Type: application/json" \
--data-raw '{"prompt":"hello","agent":"codebuddy","model":"auto","params":[{"name":"--reasoning","value":"high"}],"workdir":"D:/code/task_engine"}' 路径中的 {id} 需要替换为真实 id;Windows 使用 curl.exe, 避免被 PowerShell 的 curl 别名影响。
快速开始
代码示例
接口清单
Swagger