Keeta 开放 API：商户和合作方的系统对接接口
API 是什么
Keeta 开放 API（Application Programming Interface）是为商户和技术合作伙伴提供的标准化接口服务。通过 API，合作方可以：
- 自动管理订单（接收、确认、更新状态）
- 同步菜单数据（菜品、价格、库存）
- 集成 Keeta 核心服务到自己的系统
官网定位为"开放生态"（Open Ecosystem）的重要部分。
谁会用 API
| 用户 | 使用场景 |
|---|---|
| 连锁餐厅 | 把 Keeta 订单直接对接进自家 POS 或后厨系统，不用额外处理手机 App |
| 中型 SaaS 服务商 | 在自家平台嵌入 Keeta 外卖能力 |
| 企业订餐系统 | 与 Keeta for Business 对接，做更精细的员工餐饮管理 |
| 开发者 | 在个人或商业项目中接入 Keeta 能力（需申请） |
为什么选择 Keeta API
Keeta 在官网列出了 API 的三个卖点：
- 安全：企业级安全防护与加密传输
- 稳定：美团技术支持，高可用架构
- 标准化：RESTful API 设计，易于接入和维护
API 能做什么（功能概览）
以下为公开信息中的主要接口类别（具体接口以官方技术文档为准）：
订单类
| 接口 | 说明 |
|---|---|
| 获取新订单 | 商户轮询或接收 Webhook 推送新订单 |
| 确认订单 | 接单 / 拒单 |
| 更新订单状态 | 备餐中 / 已出餐 / 骑手已取餐 |
| 查询历史订单 | 按时间范围拉取历史订单数据 |
菜单类
| 接口 | 说明 |
|---|---|
| 同步菜品列表 | 批量上传或更新菜品信息 |
| 更新价格与库存 | 实时调整单品价格和可售状态 |
| 上下架管理 | 批量启用/停售 |
店铺类
| 接口 | 说明 |
|---|---|
| 获取店铺信息 | 读取营业时间、配送范围等 |
| 更新店铺设置 | 修改配送半径、起送价、营业状态 |
如何申请接入
步骤一：注册开发者账号
访问 Keeta 开放平台（各市场官网的"Join Us → API Integration"板块），用商户账号或开发者邮箱注册。
步骤二：申请 App 凭证
- 创建新应用，填写应用用途和接入的功能范围
- 平台审核后颁发 App ID 和 Secret Key
- 在测试环境先跑通基本接口
步骤三：开发与联调
- 参考官方技术文档（含代码示例）开发
- 在测试环境模拟真实订单流程
- 与 Keeta 技术支持对接接口问题
步骤四：上线审核
- 提交完整测试报告
- 平台审查安全性和稳定性
- 审核通过后正式启用生产环境
技术文档
Keeta 开放 API 的技术文档在各市场独立站点上可以找到，通常包含：
- 接口列表与参数说明
- 请求/响应示例
- 错误码与处理指南
- 认证方式（通常是 OAuth 2.0 或 App Key/Secret 签名）
- Webhook 回调配置说明
具体文档地址随各市场的开放平台入口进入。
限制与配额
正式使用时需要注意：
- 每个 App 有接口调用频率限制（QPS），超出会返回限流错误
- 订单 Webhook 需要商家保持接口可用，延迟过高可能导致平台重试或超时
- 敏感接口（如退款、店铺设置）权限更高，需要额外审核
建议在接入前仔细阅读官方限制说明，提前规划容量。