DEVELOPER API

接口文档

程序调用使用 AK/SK 签名,Web 使用登录令牌;所有数据按账号隔离。

AK/SK · Bearer Token 新窗口打开 Swagger

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 十六进制)

签名生成器

AK/SK 只在本页计算,不会发送到服务器
Access Key
Secret Key
接口
请求体(JSON)
时间戳 / Nonce

请求头

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 别名影响。