何时使用保留网络钩子
在您在购买时生成密钥或账户时,使用此功能用于复杂(唯一单位)库存。始终优先使用本地库存;网络钩子仅填补短缺。
- 仅在每个单位实际分配时与即时自动交付一起使用。
- 配置报价级别的默认值,或按定价选项覆盖。
- 仅限 HTTPS。可选 HMAC 签名与出站网络钩子匹配。
安全支付失败
如果您的端点超时或返回无效数据,订单保持已付款。买家被收费;您在订单上看到错误,可以重试保留或手动附加密钥。
请求合同
在付款后,RMT 每缺少一个单位 POST 一个 reserve.item 调用,包含订单、报价、选项、字段模式和数量 1。可选请求模板 JSON 与 {{placeholders}} 合并。
规范 POST 主体(截断)
json
{
"id": "rsv_…",
"type": "reserve.item",
"order": { "uid": "…", "reference": "…", "url": "…" },
"offer": { "url": "…", "title": "…", "pageUrl": "…" },
"option": { "id": 1, "name": "标准" },
"fields": [{ "id": 10, "name": "许可证", "type": "text", "required": true }],
"quantity": 1
}响应和字段映射
返回 2xx JSON。将路径映射到 Item 字段,例如 $.license,或返回 { "entries": [{ "fieldId": 10, "value": "KEY-…" }] }。
便利响应
json
{
"entries": [
{ "name": "许可证", "value": "AAAA-BBBB-CCCC" }
]
}- 仅许可证:从 $.license 或 $.key 映射一个文本字段。
- 账户:从 $.email 和 $.password 映射电子邮件和密码字段。
- 映射后缺少的必填字段计为失败。
测试、重试和安全
在报价编辑器中使用测试(发送 dryRun: true)。在订单页面上,修复端点后重试保留。切勿在电子邮件中记录秘密或完整密钥。
- 1在报价项目步骤中保存 HTTPS URL、响应映射和可选密钥。
- 2运行测试并确认映射预览。
- 3在失败时,打开订单,重试保留或手动创建/分配密钥。
在付款之前请勿调用保留
RMT 仅在付款成功后调用您的端点,因此放弃的结账不会消耗许可证。