同一数据，同一认证，三种接口形态，适配您的开发方式。
选择适合作业的接口。大多数实际集成会组合其中两种，使用 REST API 查询，使用 Webhook 响应。AI 助手加入流程时，可添加 MCP 服务器。无需受 SDK 限制，无专有协议，无单独计费。
三个开发者接口，一个机群
每种方式解决的问题类型不同。您可以只用一种，也可以全部使用。它们共享相同的按用户划分的权限模型、相同的数据结构和同一账户。
通过HTTPS传输JSON，仅需一个X-API-KEY请求头。
将事件推送到任意URL、Discord、Slack或Teams。
面向Claude、ChatGPT和其他AI助手的原生工具界面。
开发者实际用SimplyPrint构建什么
我们在打印农场、学校、创客空间、OEM合作伙伴和集成供应商中看到的真实规律：
- 自定义订单接入：报价门户或 ERP 可通过/queue/AddItem将已付款订单直接放入 SimplyPrint 队列，打印完成时触发 webhook 回调。ShipStation、Shopify 和定制订单门户都可这样对接。
- 生产仪表板：可通过API轮询获取实时打印机状态、队列深度和每日产出的大屏状态板或BI仪表板。搭配webhook可即时更新，无需轮询循环。
- Discord、Slack 和 Teams 通道：粘贴频道 webhook URL，选择团队关心的事件，即可获得原生消息。无需代码的工作室通知。
- AI助手：通过MCP连接Claude、ChatGPT或Gemini，让助手批准打印队列项、查找余量不足的料盘，或用通俗英语总结昨日打印记录。
- 硬件集成：新的AutoPrint硬件，如换板装置、推出系统和皮带改装，可通过少量gcode片段和一个Integration类接入AutoPrint集成框架。
- 白标部署：OEM合作伙伴使用相同API接口，在SimplyPrint之上打造品牌化客户体验。
用于第三方应用和平台的 OAuth2
正在构建让其他 SimplyPrint 客户连接其账户的产品？请使用 OAuth2，而不要要求每位客户粘贴 API 密钥。他们点击连接 SimplyPrint，在 simplyprint.io 登录，查看您请求的精确权限范围列表并批准。您会获得绑定到其所选账户的 Bearer token，无共享密钥、无复制粘贴凭据，也不会因丢失 API 密钥收到支持工单。
这是我们为Zapier、n8n、Make和Activepieces等平台的合作伙伴集成提供的同一OAuth2流程，请参阅工作流自动化。标准URL如下：
- 授权：simplyprint.io/panel/oauth2/authorize
- 令牌交换：simplyprint.io/api/0/oauth2/Token
- 发现：完成交换后调用/account/GetUser查找绑定账户，然后使用/api/{companyId}/{endpoint}
自定义AutoPrint硬件集成
您正在构建可自动清理打印床的硬件，例如换板器、推送机构、传送带改装件或零件收集器？SimplyPrint的AutoPrint框架就是集成接入点。每个硬件集成都会注册自己的Gcode模板、该方法的枚举项，以及一个提供营销元数据和SimplyPrint用于识别及驱动硬件的MethodDefinition的Integration类。
现有合作伙伴包括Chitu PlateCycler、JobOx、FarmLoop以及SimplyPrint AutoPrint设备本身，均通过同一集成框架连接。硬件供应商（或代表供应商的SimplyPrint）只需提供一个PHP类和一个Gcode片段，其余部分，包括方法发现、面板UI、队列交接、结束时的Gcode、推落检测，均由框架处理。如果您正在开发应作为一等AutoPrint方法推出的硬件，请通过[email protected]联系我们。
方案权限：每个开发接口适用于哪些方案
这三类开发者功能均包含在 SimplyPrint 标准套餐中，无需单独购买开发者席位，不按调用次数计费，也不按事件收费。Free、Basic、Cloud Slicer 和 Filament Manager 套餐不提供任何开发者功能，以下所有功能仅限 Pro 及以上套餐使用。
| 功能/限制 | 免费 | 基础 | 专业版 | 打印农场 | 企业版 | 学校 | 云切片 | 耗材管理器 |
|---|---|---|---|---|---|---|---|---|
|
基础API访问权限
Pro及以上套餐。通过HTTPS传输JSON，使用一个X-API-KEY请求头。可读取并进行有限写入，涵盖打印机状态、队列项目、作业、耗材库存、标签和分组。Pro每分钟60个请求，Print Farm和School为180个，Enterprise为600个。
|
||||||||
|
增强型API（完整读写）
打印农场套餐及以上。解锁通过/queue/AddItem上传文件、可启动打印的打印队列修改、直接发送G-code以及批量写入操作。享用该套餐较高的速率限制额度。
|
||||||||
|
Webhooks
打印农场套餐及以上。完整的多渠道Webhook系统，支持常规JSON、Discord、Slack和Microsoft Teams，提供60多个事件、可选HMAC签名和每次投递历史记录。不收取每个Webhook或每次投递费用，也不限制事件数量。
|
||||||||
|
面向AI助手的MCP服务器
Pro及以上套餐。连接Claude（claude.ai、Claude Desktop、Claude Code）、ChatGPT、Gemini、Cursor及其他支持MCP的助手，以自然语言管理您的打印机群。基于OAuth，按权限范围控制，无单次调用费用。助手本身的订阅费用由您向其供应商支付。
|
||||||||
|
Zapier、n8n、Make 和 Activepieces
Pro及以上套餐可通过基于OAuth2的官方集成进行连接。由于这些集成遵循账户的API级别，Print Farm及以上套餐可通过其获得完整写入权限。
|
您想详细了解我们的套餐吗？
查看完整价格和功能对比入门指南
选择适合作业的接口，然后开始：
- REST API：登录面板，打开账户设置→API，为密钥命名后复制。然后在apidocs.simplyprint.io阅读完整参考文档。如果您希望基于文档本身构建工具，其中还包含llms.txt文件和结构化的api/index.json目录。
- Webhooks：在控制面板中打开Webhooks页面，粘贴目标URL（任意URL，或Discord/Slack/Teams频道Webhook），选择您关心的事件。测试发送只需一键。操作说明：Webhooks功能详解。
- MCP：将https://simplyprint.io/api/mcp粘贴到您的AI助手自定义连接器/MCP服务器设置中，完成OAuth同意流程，然后向助手提问。分步说明：通过MCP将SimplyPrint连接到任何AI助手。
- OAuth2合作伙伴应用：通过OAuth2客户端申请表申请客户端，然后将您的应用指向上述URL。
常见问题
使用API需要哪个套餐？
API是否有版本管理？
速率限制是多少？
如何获取API密钥？
API密钥还是OAuth2，应该使用哪个？
API、Webhook、MCP，有何区别？
是否有官方SDK？
有沙盒或测试环境吗？
我的数据会被用于训练任何AI吗？
如果您遇到困难，可以在哪里获得帮助？
分步设置指南
面向每个客户端、涵盖所有界面的完整操作指南均在帮助中心的开发者部分中提供，包括API密钥设置、Discord / Slack / Teams的webhook配置，以及Claude、ChatGPT和Gemini CLI的MCP设置指南。