BB_URL="${BAMBUDDY_URL}/api/v1"
BB_AUTH="X-API-Key: ${BAMBUDDY_API_KEY}"

SINCE=$(date -u -d '7 days ago' +%Y-%m-%dT%H:%M:%S 2>/dev/null || \
        date -u -v-7d +%Y-%m-%dT%H:%M:%S)

curl -s -H "$BB_AUTH" "$BB_URL/archives/?since=$SINCE" | \
  jq '{
    total_prints: length,
    total_filament_g: [.[].filament_used_g // 0] | add,
    total_cost: [.[].cost // 0] | add
  }'

Bambuddy 技能

您拥有 Bambuddy REST API 的完全访问权限。使用 curl 发起所有请求。
切勿自行发明端点路径——请严格使用下方记录的路径。

认证与基础 URL

每个请求都必须包含 API 密钥标头。基础 URL 来自
BAMBUDDY_URL 环境变量（末尾无斜杠）。

bash

便捷别名 — 每次调用均复用此模式

BBURL=${BAMBUDDYURL}/api/v1
BBAUTH=X-API-Key: ${BAMBUDDYAPI_KEY}

GET 示例

curl -s -H $BBAUTH $BBURL/system/info | jq .

POST 示例

curl -s -X POST -H $BB_AUTH -H Content-Type: application/json \ -d {key:value} $BB_URL/some/endpoint | jq .

PATCH 示例

curl -s -X PATCH -H $BB_AUTH -H Content-Type: application/json \ -d {key:value} $BB_URL/some/endpoint | jq .

DELETE 示例

curl -s -X DELETE -H $BBAUTH $BBURL/some/endpoint

除非需要原始输出，否则始终通过 jq . 管道处理 JSON 响应以增强可读性。
对于二进制响应（摄像头快照、缩略图），请省略 jq 并保存到文件。

---

API 分类与端点

1. 系统

bash

系统信息（版本、路径、数据库统计）

curl -s -H $BBAUTH $BBURL/system/info | jq .

---

2. 认证 / 用户 / 组

bash

当前用户信息

curl -s -H $BBAUTH $BBURL/auth/me | jq .

认证状态（是否启用认证）

curl -s -H $BBAUTH $BBURL/auth/status | jq .

列出用户

curl -s -H $BBAUTH $BBURL/users | jq .

获取特定用户

curl -s -H $BBAUTH $BBURL/users/{user_id} | jq .

用户项目计数

curl -s -H $BBAUTH $BBURL/users/{user_id}/items-count | jq .

列出组

curl -s -H $BBAUTH $BBURL/groups | jq .

可用权限

curl -s -H $BBAUTH $BBURL/groups/permissions | jq .

获取特定组

curl -s -H $BBAUTH $BBURL/groups/{group_id} | jq .

---

3. API 密钥

bash

列出所有 API 密钥

curl -s -H $BBAUTH $BBURL/api-keys/ | jq .

创建新 API 密钥

curl -s -X POST -H $BB_AUTH -H Content-Type: application/json \ -d { name: my-key, can_queue: true, cancontrolprinter: true, canreadstatus: true, printer_ids: null, expires_at: null } $BB_URL/api-keys/ | jq .

获取特定 API 密钥

curl -s -H $BBAUTH $BBURL/api-keys/{key_id} | jq .

更新 API 密钥

curl -s -X PATCH -H $BB_AUTH -H Content-Type: application/json \ -d {name: updated-name, enabled: false} \ $BBURL/api-keys/{keyid} | jq .

删除 API 密钥

curl -s -X DELETE -H $BBAUTH $BBURL/api-keys/{key_id}

---

4. 打印机

bash

列出所有打印机

curl -s -H $BBAUTH $BBURL/printers/ | jq .

获取特定打印机

curl -s -H $BBAUTH $BBURL/printers/{printer_id} | jq .

实时状态（温度、进度、阶段、AMS、速度等）

curl -s -H $BBAUTH $BBURL/printers/{printer_id}/status | jq .

当前打印用户

curl -s -H $BBAUTH $BBURL/printers/{printer_id}/current-print-user | jq .

打印机封面图片（二进制 PNG — 保存到文件）

curl -s -H $BBAUTH $BBURL/printers/{printer_id}/cover -o cover.png

打印机 SD/存储中的文件

curl -s -H $BBAUTH $BBURL/printers/{printer_id}/files | jq .

打印机存储信息

curl -s -H $BBAUTH $BBURL/printers/{printer_id}/storage | jq .

MQTT 调试日志

curl -s -H $BBAUTH $BBURL/printers/{printer_id}/logging | jq .

AMS 插槽预设

curl -s -H $BBAUTH $BBURL/printers/{printer_id}/slot-presets | jq .

特定插槽预设

curl -s -H $BB_AUTH \ $BBURL/printers/{printerid}/slot-presets/{amsid}/{slotid} | jq .

打印对象（当前作业平台对象）

curl -s -H $BBAUTH $BBURL/printers/{printer_id}/print/objects | jq .

运行时调试信息

curl -s -H $BBAUTH $BBURL/printers/{printer_id}/runtime-debug | jq .

摄像头状态

curl -s -H $BBAUTH $BBURL/printers/{printer_id}/camera/status | jq .

USB 摄像头

curl -s -H $BBAUTH $BBURL/printers/usb-cameras | jq .

更新打印机（名称、IP、访问码等）

curl -s -X PATCH -H $BB_AUTH -H Content-Type: application/json \ -d {name: New Name} $BBURL/printers/{printerid} | jq .

添加打印机

curl -s -X POST -H $BB_AUTH -H Content-Type: application/json \ -d { name: My X1C, ip: 192.168.1.100, access_code: 12345678, serial: 01S00A000000000 } $BB_URL/printers/ | jq .

删除打印机

curl -s -X DELETE -H $BBAUTH $BBURL/printers/{printer_id}

打印机控制（暂停、恢复、停止）

curl -s -X POST -H $BB_AUTH -H Content-Type: application/json \ -d {command: pause} $BBURL/printers/{printerid}/control

命令选项：pause | resume | stop

---

5. 存档

bash

列出存档（支持筛选/分页）

curl -s -H $BBAUTH $BBURL/archives/ | jq .

带筛选条件

curl -s -H $BB_AUTH \ $BBURL/archives/?page=1&pagesize=20&search=benchy&printer_id=1 | jq .

获取特定存档

curl -s -H $BBAUTH $BBURL/archives/{archive_id} | jq .

存档统计摘要

curl -s -H $BBAUTH $BBURL/archives/stats | jq .

更新存档元数据

curl -s -X PATCH -H $BB_AUTH -H Content-Type: application/json \ -d {name: Updated Name, rating: 5, notes: Great print} \ $BBURL/archives/{archiveid} | jq .

删除存档

curl -s -X DELETE -H $BBAUTH $BBURL/archives/{archive_id}

重新打印存档

curl -s -X POST -H $BB_AUTH -H Content-Type: application/json \ -d {printerid: 1, amsmapping: []} \ $BBURL/archives/{archiveid}/reprint | jq .

下载存档 3MF 文件

curl