在您的 POS 上打造自己的网站和应用：Bill&Go Shop API

大多数 POS 系统把自己知道的东西藏起来。菜单、价格、当天的销售和订单都锁在 POS 自己的界面后面，当您的网站、会计或外卖合作伙伴需要时，就得有人再录入一遍。价格对不上，卖完的菜还挂在网站上，表格里的数字总是晚一天。

Bill&Go 的 Shop API 正好相反：它是一扇门，让您自己的系统可以读取您的 POS 并向它发送订单，用的是您自己创建、一秒就能停用的密钥。完整的参考文档就公开在本网站上，所以您，或为您做网站的开发者，可以在注册之前就看清楚它到底能做什么。

您自己的网站，直接接单

打造配得上您店铺的网站：用您自己的颜色、自己的网址，用您或您的开发者喜欢的任何工具。Shop API 把您的 POS 知道的一切都提供给它：

• 实时菜单。 分类、带英文和高棉语名称的菜品、价格、照片、选项及可选数量，以及此刻已卖完的东西。在柜台改一个价格，网站上马上就变。
• 您的分店。 每家门店的地址、地图位置、电话、营业时间和配送费，可用于“找到我们”页面，或让顾客选择在哪家下单。
• 订单直达厨房。 网站下单并标记为已付款；订单到达 POS，像其他订单一样在厨房打印，有自己的取餐号，之后由 POS 接手。
• 订单状态。 网站可以跟踪每笔订单的确认、制作和完成，告诉顾客进度。

您自己的手机应用

手机应用也一样：在 App Store 和 Google Play 上用您店铺的名字上架，顾客在您的应用里浏览菜单、下单和付款，订单直接到达您的 POS。会员、优惠和推送通知都由您来设计，因为应用是您的。

须知。 应用或网页本身绝不能保存密钥：任何人都能把它从应用里取出来。您的应用连接您自己的一台小服务器，由这台服务器保存密钥并与 Bill&Go 通信。您的开发者熟悉这种做法；参考文档写明了要发送什么。

还有店铺周边的一切

• 给会计的销售数据。 每家门店的每日销售，每天早上自动进入会计系统或 Google Sheet，无需手动导出。
• 与您同步的外卖合作伙伴。 菜单来自 POS，所以您在柜台改的价格，就是合作伙伴显示的价格。
• 库存随处可用。 每家门店的库存数，可用于给供应商的订货单，或让网站隐藏已卖完的东西。
• 您自己的数据面板。 订单变化时逐页读取，让其他系统或报表保持最新。

从设计上就安全

密钥由店主在管理后台的设置 → API 密钥下创建，每个密钥都写明它能做什么：

• 只读，或者也能下单。 给会计的密钥只能读取；给网站或应用的密钥可以下单。
• 一家分店，或全部分店。 密钥可以固定在一家门店，这样它永远看不到其他门店。
• 一秒停用。 撤销一个密钥，它立即失效；其他一切不变。管理后台会显示每个密钥最后一次使用的时间。
• 只用于 Shop API。 密钥只在 Shop API 上有效，别处都不行：它永远无法登录管理后台，也无法更改您的设置。

您的数据始终是您的：API 随时以普通 JSON 格式为您读出。

如何开始

1. 确认店铺使用的是 Starter 或更高的方案：Shop API 是付费方案中的连接之一。每家新店铺都有一个月的 Pro 可以试用。
2. 在管理后台打开设置 → API 密钥并添加一个密钥：给它起名（“网站”），选择它能做什么、能用哪些门店。
3. 复制密钥。它只完整显示一次；把它放在您的服务器上，绝不放在网页或应用里。
4. 每次向 `https://api.billandgo.app/v1` 发送请求时都带上您的 API 密钥；参考文档有可直接复制的示例。从 `GET /stores` 和 `GET /menu` 开始。

Shop API 参考文档列出了每个地址、它返回什么以及每种错误，并附有可复制的示例。

提示。 在购买之前，请您考虑的每个 POS 都给您看它的 API 参考文档。如果没有写下来，您的数据能不能拿到，就全看供应商愿不愿意。