把任何系统连接到 zmle
带权限范围密钥的 REST API 和带签名的 Webhook。保留您自己的网站、同步其他工具,或在您的工作空间之上进行开发。
示例数据
从您自己的网站创建线索
身份验证
在工作空间中创建一个只含所需权限范围的密钥,并作为 Bearer 令牌发送。密钥可以设置过期,也可随时吊销;系统只保存每个密钥的哈希值。
# 从你自己的表单 POST 一条线索 curl -X POST https://yourname.zmle.com/api/v1/inquiries \ -H "Authorization: Bearer $ZMLE_API_KEY" \ -H "content-type: application/json" \ -d '{"type":"QUOTE","name":"Dana Lee", "email":"dana@example.com", "subject":"AC service, 3 units"}' # → 201 { "data": { "id": "…", "source": "api" } }
文档
在工作区之上开发所需的一切:REST API、Webhook、面向 AI 客户端的 MCP 服务器、API 密钥以及用于试用的沙盒。
API v1 参考
REST API 的每个端点及其方法、路径和所需权限范围,由 API 自身提供的同一份 OpenAPI 文档生成。
Webhook
业务事件发送到您的 HTTPS 端点,带签名、自动重试并记录日志。
MCP 服务器
通过 Model Context Protocol 将 AI 客户端连接到工作区,使用该人员本人的权限。
API 密钥与权限范围
密钥可以读取和写入哪些数据,以及它从创建者那里继承的分支和权限限制。
沙盒工作区
在带有示例数据的个人演示工作区中试用 API。您在那里所做的一切都不会到达外部世界。
安全与数据
API、Webhook 和 MCP 服务器绝不会发送哪些数据,密钥和签名如何保护工作区,以及数据进入 AI 客户端后由谁负责。
资源
输入和输出均为 JSON。金额为最小货币单位的整数,并明确标注币种。列表支持分页和搜索。
- Customers/api/v1/customers
- Leads/api/v1/inquiries
- Quotations/api/v1/quotations
- Invoices/api/v1/invoices
- Orders/api/v1/orders
- Catalog/api/v1/products
- Bookings/api/v1/booking-services
- Webhooks/api/v1/events
- Account/api/v1/me
- Stock/api/v1/warehouses
- Appointments/api/v1/appointments
- Point of sale/api/v1/pos-sales
- Tasks/api/v1/tasks
- Files/api/v1/attachments
- Apps/api/v1/session/handoff
- Sensors/api/v1/sensors/readings
Webhook
为您关心的事件订阅一个接收地址。每次推送都使用 HMAC-SHA256 和时间戳签名;如果您的服务器未响应,会以递增间隔重试,并记录日志以便重新发送。
限制与错误
每个密钥有 300 个请求的额度,每秒补充 5 个,另有按地址的限制;带错误代码的清晰 JSON 错误、逐字段的校验信息,以及每个响应中的版本标头。
部分事件
inquiry.createdquotation.acceptedinvoice.paidpayment.receivedorder.placedappointment.bookedpos.sale_completedstock.lowticket.createddeal.won