概述
程序化分发
合作伙伴轮询或接收推送的用车报价，包含车辆等级、定价与 SLA 元数据。
预订创建接口接受含机场航站楼地点 ID 的结构化行程。
Webhook 向合作伙伴接口广播状态变更——已分配、途中、已完成。
- OAuth 客户端凭证
- 用车报价接口
- 状态 Webhook
- OpenAPI 规范
如何运作
从沙箱密钥到生产流量
- 步骤 1
入驻
合作伙伴在门户中获取沙箱凭证与示例请求体。
- 步骤 2
认证
联合测试脚本验证报价接受、取消及 Webhook 签名流程。
- 步骤 3
扩展
生产密钥激活，配备按租户速率限制与监控仪表盘。
优势
开发者收益
更快上市
OTA 无需 Red Carpet 工程人员定制开发即可完成集成。
事件驱动运营
Webhook 消除轮询负载，缩短状态延迟。
版本稳定性
语义化版本在字段扩展时保护现有集成不受影响。
安全
API 安全
OAuth 客户端凭证可在合作伙伴门户中轮换，并立即失效。
Webhook 签名使用带时间戳容差的 HMAC-SHA256 防止重放攻击。
- 客户端凭证轮换
- Webhook HMAC
- 按租户速率限制
- IP 许可名单（可选）
集成
接口覆盖范围
OpenAPI 文档记录用车报价、预订、取消及司机状态回调。
Postman 集合与 NestJS 示例消费者随认证包一同提供。
- OpenAPI 3.1 规范
- Postman 集合
- 沙箱 Webhook
- 用量指标仪表盘
应用场景
集成模式
OTA 需求
市场平台向区域供应合作伙伴推送报价以供接受。
企业 ERP
企业从内部差旅工具创建经审批的行程。
酒店 PMS
物业将地面交通自动附加至客房预订。
支持