按需拉取，重要时推送。
SimplyPrint API适合由您的系统提问时使用。Webhooks则让SimplyPrint在发生任何变化时立即通知您，无需轮询、无需定时任务，也不会错过事件。
推送事件，无需轮询
Webhook是您提供给SimplyPrint的URL。每当您的账户中发生您订阅的事件，例如打印开始、任务失败、队列项获批或备件库存不足，SimplyPrint就会向该URL发送包含事件负载的HTTP POST。无需轮询，无需应对速率限制，也不用担心“是否漏掉了某项？”，只需一个可接入任何支持HTTP系统的事件流。
按需创建任意数量的Webhook。精确选择每个Webhook关注的事件。无需删除即可停用。可在历史记录中查看每次投递。这正是整个Web所依赖的基础机制，现在已接入您的3D打印机群。
四种交付格式，一个Webhook系统
SimplyPrint会根据URL自动识别目标并按目标格式生成有效负载。将Webhook指向Discord，即可获得带颜色、字段和时间戳的规范嵌入消息。将其指向Slack，即可获得Slack Block Kit消息。将其指向Microsoft Teams，即可获得自适应卡片。将其指向任何其他服务，即可获得干净的原始JSON，供您任意使用。
适用于Zapier、n8n、Make或您自己后端的简洁POST正文。
粘贴频道webhook URL即可获得丰富的嵌入内容，无需机器人。
可通过任何Slack入站Webhook发送原生Block Kit消息。
发布到 Teams 工作流或连接器 URL 的自适应卡片。
您的机群生成的每个事件，均按清晰类别归类
为每个Webhook精确订阅其所需事件。团队共用的Discord频道可能只关注打印完成和打印失败。Zapier自动化可能订阅队列项目已批准。维护仪表板可能需要所有maintenance.*事件。每个Webhook均由您决定。
- 打印任务事件：已开始、已暂停、已恢复、已取消、已完成、失败、已清理打印床、已跳过对象
- 打印机事件：AutoPrint状态、喷嘴尺寸、材料、自定义标签已分配/已移除、故障状态、AI状态、检测到AI故障、AI故障误报、AutoPrint最大循环次数
- 组织事件，账户AutoPrint状态、新用户注册、用户等待批准
- 打印队列：已添加、已删除、已移动、已恢复、待审批、已批准、已拒绝、队列已清空
- 耗材：已创建、已更新、已删除、已分配给打印机、已取消分配。
- 维护：维护工单已创建/开始/完成/取消/逾期/重新开启/更新/删除，问题已报告/解决，备件已创建/更新/删除，库存已调整、库存不足，维护任务已完成/跳过，计划已创建/更新/删除
- 余额：扣费、退款、充值、调整
- 配额：新请求、请求已解决、已调整、已重置
便于编写对接代码的数据负载结构
每个常规格式的webhook推送从外部看都一样：一个信封，包含event名称、ISO timestamp和来源webhook_id，并封装一个data对象，其结构因事件而异。
job.done事件的data对象包含打印任务、打印机、文件、用户和耗时。filament.assigned事件包含耗材、打印机及其所在的工具。maintenance.job_overdue事件包含任务、打印机、负责用户和原始到期日。外层结构相同，数据因事件而异，因此您的代码只需一个switch语句即可处理整个事件流。
了解Weshape如何使用Webhooks管理~50 printers
Order queueing is a webhook that feeds into the SimplyPrint API.
先测试、采样和检查，再将任何内容部署到生产环境
Webhooks应该简单明了。SimplyPrint为您提供三项工具，让它们真正易于使用：查看您将收到的内容、发送测试请求，以及回顾已发生的每次投递。
发送测试事件
可按需从任意订阅发送真实格式的载荷。
示例载荷
编写任何代码前，先浏览准确的有效负载结构。
投递历史记录
每次投递的URL、HTTP状态、响应正文和时间戳。
您的Webhook送达后是什么样子
Discord、Slack和Teams格式会在各应用中呈现为原生嵌入卡片，含丰富标题、字段化负载和可选的打印机缩略图。以下是直接从Discord频道截取的三个真实投递，来自一个运行SimplyPrint的打印农场。只需配置一次格式，SimplyPrint会处理嵌入卡片。
维护逾期
已排期的维护工单错过截止日期：工单名称、打印机、优先级、计划和分组全在一张卡片中。
维护工单已创建
新维护工单已排期：打印机、分组和优先级会立即显示在您的团队频道中。
备件库存
库存变更：零件删除、库存调整和补货均作为独立事件发送，以便工作流工具对每项变更作出响应。
可选密钥验证，确认请求确实来自SimplyPrint
为每个webhook设置密钥，SimplyPrint会通过每次投递的X-SP-Secret标头发送该密钥，以便您的接收端验证请求确实来自我们，而非某个猜到您URL的随机IP。对于无需此项的内部网络webhook，可不设置密钥。密钥泄露时随时轮换，过去的投递不会失效，之后的投递将使用新密钥。
每个webhook也可独立启用/禁用。切换开关即可暂停产生过多通知的集成，同时保留其事件订阅和历史记录。
用户实际会接入什么
这些是我们在使用SimplyPrint的打印农场、学校、创客空间和产品团队中最常见的使用模式。
将job.done和job.failed发送到您团队的频道。
批准队列项后，触发开具发票或履约流程。
将逾期维护或备件库存不足通知运维团队。
让教师实时查看学生提交内容。
完整开发者体验的推送部分
Webhooks可与SimplyPrint的其他开发者功能自然配合：
- SimplyPrint API让您的代码可按需拉取任何状态，包括打印机、队列、文件、耗材和任务。
- Webhooks让SimplyPrint在发生变更时推送通知，无需您轮询。
- SimplyPrint MCP服务器可让AI助手（Claude、ChatGPT）通过经审核的工具注册表读取并操作同一设备群。
方案权限：哪些方案包含 Webhook？
Webhooks已包含在打印农场和企业版套餐中，无需额外付费。没有按Webhook收费、按投递收费或事件数量上限。
| 功能/限制 | 免费 | 基础 | 专业版 | 打印农场 | 企业版 | 学校 | 云切片 | 耗材管理器 |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
完整多渠道Webhook系统：常规JSON、Discord、Slack和Microsoft Teams，包含完整事件目录、可选密钥验证及每次发送历史记录。
|
您想详细了解我们的套餐吗？
查看完整价格和功能对比常见问题
如何向Discord、Slack或Microsoft Teams发送事件？
discord.com/api/webhooks、hooks.slack.com/services或Teams工作流URL），并以该平台的原生格式处理负载。无需安装机器人、应用或中间件。您可以订阅哪些事件？
如何验证请求确实来自SimplyPrint？
您可以查看已投递的内容吗？
您可以在上线前测试Webhook吗？
这与SimplyPrint API有何不同？
如果您的服务器宕机，如何重试？
SimplyPrint会重试失败的投递吗？
投递尝试记录会保存多久？
哪些套餐包含Webhook？
分步设置指南
如需了解创建首个webhook的指南，包括Discord、Slack和Microsoft Teams URL的具体说明，请参阅完整的webhook帮助中心文章。