代码
Partner API v1、基于 @delieta/shop-runtime 的店铺契约和刷新信号 — 从这里开始集成。
本部分面向把 Delieta 接入店铺、收银台或自有后端的人。公司面板的介绍见功能。
这里有什么
三个页面各回答一个问题。
| 问题 | 页面 |
|---|---|
| 如何读取菜单、接收店铺订单、从收银台创建订单、接收预订或餐饮询价？ | Partner API |
如何在 @delieta/shop-runtime 上搭建一个不泄露密钥的店铺？ | 店铺契约 |
| 状态变化时 Delieta 会通知我的服务器吗？ | Webhook — 不会，请用 GET 查询状态。店铺只会收到一个带签名的刷新信号。 |
同一份契约的机器可读版本：GET /api/v1/openapi（无需密钥，按 IP 限流）。这些页面以该文档为准进行校验。
所有页面通用的规则
密钥决定公司。请求体中的 tenantSlug 或 companyId 会被忽略。
金额是整数格罗希。3200 即 32.00 兹罗提。v1 只有 PLN 一种货币。
错误采用 RFC 9457 application/problem+json。根据 code 字段判断错误，绝不根据 title。
可发布密钥恰好拥有 catalog:read 和 checkout:create：读取菜单和店铺设置，接收店铺订单、预订和询价。秘密密钥创建收银台订单并估算 ETA。两种密钥都只放在服务器端，绝不放进浏览器 — 店铺契约能帮你分清。
第一次集成的分步说明：开发者入门。