SimplyPrint 3D打印机API

通过一次API调用开始打印

从您的代码到让挤出机动起来的最快路径：向/queue/AddItem POST 文件 ID，指定一台或多台打印机，SimplyPrint 会处理后续流程。后台中，队列运行与面板相同的匹配、审批和路由逻辑，因此打印会在与人工点击“打印”时相同的打印机上开始。

curl -X POST "https://api.simplyprint.io/{companyId}/queue/AddItem" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": "abc123",
    "amount": 1,
    "for_printers": "42,43",
    "position": "top"
  }'

{
  "status": true,
  "message": null,
  "approval_status": "not_required",
  "id": 90817,
  "queue_position": 1
}

读取状态。发送命令。使用相同的身份验证请求头。

一次调用即可列出所有打印机。响应与面板所呈现的打印机对象相同，包含状态、当前任务、温度、已装载的耗材等全部信息。

curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"

curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/Pause" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "pid": 42 }'

curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/SendGcode" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "pid": 42, "gcode": "G28 X Y" }'

用于合作伙伴集成的 OAuth2

正在构建供其他 SimplyPrint 客户使用的第三方应用？请使用 OAuth2，让每位客户可通过同意界面连接自己的账户，无共享 API 密钥，无复制粘贴的密钥。这与我们官方 Cura 集成使用的流程相同，也与我们为 Zapier、n8n、Make 和 Activepieces 等平台上的合作伙伴集成提供的流程相同。

# 1) Send the user to the consent screen
https://simplyprint.io/panel/oauth2/authorize
  ?response_type=code
  &client_id=YOUR_CLIENT_ID
  &redirect_uri=https://your-app.example.com/callback
  &scope=printers.read+queue.write+files.read
  &state=<random>

# 2) Exchange the returned code for an access token
curl -X POST "https://simplyprint.io/api/0/oauth2/Token" \
  -d "grant_type=authorization_code" \
  -d "code=AUTH_CODE_FROM_CALLBACK" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "redirect_uri=https://your-app.example.com/callback"

# 3) Discover the bound company, then call API as that company
curl "https://simplyprint.io/api/0/account/GetUser" \
  -H "Authorization: Bearer ACCESS_TOKEN"

完整参考文档见 apidocs.simplyprint.io

涵盖所有端点、请求和响应结构、错误代码、OAuth2流程和范围列表。文档也对AI友好，提供用于一次性供AI读取的llms.txt，以及用于在目录基础上构建工具的结构化api/index.json。

常见问题