1. 身份認證 (Authentication)
所有 API 請求均須於 HTTP Header 中附帶授權金鑰：
Host: api.teamotto.com.cn
Content-Type: application/json
Authorization: Bearer pno_live_99f182c73810a4b2e
X-Store-ID: 1024
2. 通用響應與狀態碼
所有介面均以統一結構回傳，code 為業務狀態碼，data 為業務資料載體。
200 請求成功
401 授權失效 / Key 錯誤
403 門店 ID 無權限
429 請求頻率超限 (限 600/min)
GET
/stores
取得集團旗下門店清單
Response (200 OK)
{
"code": 200,
"data": [
{ "store_id": 1024, "name": "中環總店", "status": "open" },
{ "store_id": 1025, "name": "旺角分店", "status": "open" }
]
}
GET
/stores/{store_id}/tables
查詢特定門店即時桌位與開桌狀態
Response (200 OK)
{
"code": 200,
"data": [
{ "table_no": "A01", "seats": 4, "status": "occupied", "active_order_id": "PNO202608130088" },
{ "table_no": "A02", "seats": 2, "status": "vacant", "active_order_id": null }
]
}
GET
/menu
取得最新菜單與品項屬性
Response (200 OK)
{
"code": 200,
"categories": [
{
"category_id": 10,
"name": "熱門港式點心",
"items": [
{ "item_id": 8012, "name": "招牌菠蘿油", "price": 18.00, "stock": 45 },
{ "item_id": 8015, "name": "絲滑凍奶茶", "price": 22.00, "stock": 120 }
]
}
]
}
PUT
/menu/items/{item_id}/stock
即時更新品項可售庫存（沽清同步）
Request Body
{
"stock": 0,
"action": "sold_out" // sold_out / restock
}
POST
/orders
建立顧客桌邊掃碼訂單
Request Body
{
"table_no": "A03",
"order_type": "dine_in",
"items": [
{ "item_id": 8012, "qty": 2, "price": 18.00 },
{ "item_id": 8015, "qty": 1, "price": 22.00, "options": ["少冰", "微糖"] }
]
}
Response (200 OK)
{
"code": 200,
"data": {
"order_id": "PNO202608130092",
"total_amount": 58.00,
"status": "pending_payment"
}
}
GET
/orders/{order_id}
查詢單筆訂單詳情與狀態流轉
Response (200 OK)
{
"code": 200,
"data": {
"order_id": "PNO202608130092",
"status": "paid", // pending_payment / paid / cooking / done
"kds_stations": ["bar_station", "wok_station"]
}
}
PUT
/kds/orders/{order_id}/status
更新廚房 KDS 製作/出餐狀態
Request Body
{
"station": "bar_station",
"status": "completed" // pending / cooking / completed
}
GET
/members/{openid}
查詢會員積分與標籤（私域營運）
Response (200 OK)
{
"code": 200,
"data": {
"openid": "oXz9s5k...",
"points": 1280,
"tags": ["下午茶常客", "奶茶愛好者"]
}
}