開發者 API：完整接口文檔
想點就點把商家端接口全面開放：你可以只接一個場景（例如把訂單同步進自家 ERP），亦可以全量自建前端。以下為全部端點，支持搜索；字段以實際返回為準。
通用約定
所有接口均為 HTTPS POST，請求體 application/json（部分表單接口兼容 application/x-www-form-urlencoded）。
統一返回結構：{"code": 200, "msg": "成功", "data": {...}}。code 200 為成功，其餘為業務錯誤；HTTP 狀態碼正常時恆為 200。
金額一律為字符串、兩位小數（如 "88.00"），幣種跟隨門店設置。時間格式 YYYY-MM-DD HH:mm:ss，歸屬日以完單時間為準。
| code | 含義 |
|---|---|
| 200 | 成功 |
| 100 | 參數缺失或不合法 |
| 101 | 未登入或 token 過期（請重新登入） |
| 102 | 無權限執行該操作 |
| 429 | 請求過於頻繁，請稍後重試 |
| 500 | 服務異常（請附 out_trade_no／時間反饋給我們） |
認證方式
登入接口成功後，服務端以 Cookie: token（JWT）下發憑證，有效期 30 天、每次請求自動續期；後續請求需攜帶該 Cookie（瀏覽器自動處理；後端對接方請自行保存並回傳）。
顧客端使用微信授權或手機驗證碼登入；商家後台／POS 使用員工帳號登入。兩類 token 權限互不相通。路徑前綴為 /api/login、/api/payment、/api/banner、/api/menu、/api/store、/api/cart 的公開讀取接口可匿名訪問，其餘接口未登入返回 code 101。
測試環境：https://orderstaging.teamotto.net（示範店 Pizza King Mong Kok，store_id=13，演示帳號向我們申請）。
訂單狀態速查
| status | 含義 |
|---|---|
| 0 | 等待付款 |
| 1 / 10 / 11 / 21 | 已確認，準備中（11 堂食、21 外賣） |
| 22 | 外賣待取餐（含取餐號 number_pick_up） |
| 12 / 23 / 24 / 25 | 已完成（堂食清枱／外賣核銷） |
| 41 / 42 | 已取消／已作廢 |
支付渠道編碼：1 微信支付、2 QFPay、91 現金、92 八達通、93 FPS、94 信用卡。顧客下單後以 out_trade_no 輪詢 Order/getInfoByOutTradeNo（建議 4 秒間隔）獲取狀態推進。
登入認證Authentication
/api/Login/postLoginForWeChat顧客微信授權登入（小程序 code 換 openid）。code請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Login/postLoginForPhone顧客手機驗證碼登入。phone_codephone_number請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Login/postLogout登出並清除 token。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Login/postLoginForTest測試環境登入（僅測試庫可用）。user_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Login/postLoginForStaff員工／商家後台登入。成功後以 Cookie（token）下發 JWT，有效期 30 天並自動續期。usernamepasswordbrand請求：HTTPS POST；返回統一結構 {code, msg, data}。
門店與枱位Stores & Tables
/api/Store/getBrandByHostForClient按域名反查品牌資料（顧客端進入用）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Store/getInfoForStaff讀取當前員工所屬門店資料。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Store/postEditForStaff更新門店資料（營業狀態、公告、外賣設置等）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Store/getInfoById讀取指定門店公開資料。store_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Store/getListForPage門店列表（支持經緯度排序與搜索），供連鎖總覽與顧客端選店。pagerowskeywordbrand_idlatitudelongitudesort_type請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Store/getLocation讀取門店定位資料。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Store/getSeatListForPageForStaff枱位分頁列表。pagerowskeyword請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Store/getSeatListAllForStaff全部枱位（不過濾）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Store/postSeatAddMultipleForStaff批量新增枱位。array_list請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Store/postSeatDeleteForStaff刪除枱位。store_seat_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
橫額廣告Banners
/api/Banner/getListAllByStoreId讀取門店橫額廣告（按位置）。store_idposition請求：HTTPS POST；返回統一結構 {code, msg, data}。
購物車Cart
/api/Cart/getListAll按門店＋枱位讀取購物車。store_idnumber_seat請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Cart/postEdit新增／修改購物車條目。cart_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Cart/postDelete刪除購物車條目。cart_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Cart/postDeleteAll清空購物車。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
訂單Orders
/api/Order/getInfoByOutTradeNo按商戶單號查訂單（顧客端輪詢狀態）。out_trade_no請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/getInfoForStatisticForStaff營業統計總覽（按日）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/getInfoForStatisticTwoForStaff營業統計（餐段／渠道維度）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/getInfoForStatisticThreeForStaff營業統計（熱銷菜品維度）。date請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/getInfoForStatisticChartForStaff統計圖表數據（指定範圍與渠道）。rangechanneldate請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/getInfoByOutTradeNoForStaff員工端按商戶單號查訂單詳情。out_trade_no請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/getListForPage訂單分頁列表（顧客端「我的訂單」）。pagerowskeywordstore_idtypestatusis_pending請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/getListForPageForStaff門店訂單分頁（狀態、餐段、時間範圍過濾）。pagerowskeywordtypestatusis_pendingstart_timeend_time請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postAddForUser顧客下單（堂食或自取外賣；返回 out_trade_no 供收銀台使用）。array_item請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postAddForStaff門店端代客落單（POS／平板）。array_item請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postSyncOfflineForStaff（說明整理中）client_uuidplaced_atpayment_methodpaid_amountarray_item請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postModifyForPaidForStaff標記訂單已付款（現金／八達通／FPS 等離線支付方式）。out_trade_nopayment_methodpaid_amount請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/getTodayLiveForStaff今日實時營業動態（門店大屏／儀表盤）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/getAiInsightForStaffAI 營業洞察摘要。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postModifyForCancelForStaff取消／作廢訂單（附原因）。out_trade_nocancel_reason請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postModifyForCompletePackForStaff外賣出品完成（進入待取餐，派取餐號）。out_trade_nonumber_pick_up請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postScanResolveForStaff掃碼解析（出餐碼／取餐核銷碼，支持丟字兜底）。scan_text請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postPrintForStaff手動補打收據／後廚單。out_trade_no請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postModifyForItemRefundForStaff單品退菜／退款。order_item_idquantityrefund_reason請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postModifyForSeatClearedForStaff堂食枱位清理完成（訂單歸入已完成）。out_trade_no請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Order/postItemModifyForProcessedForStaff單品出品完成（KDS 逐項出餐）。order_item_idorder_item_combo_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
支付回調Payment Callbacks
/api/Payment/notifyWeChatPayGlobal微信支付服務端回調（僅支付平台調用，第三方勿接）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Payment/notifyQFPayGlobalQFPay 支付回調（僅支付平台調用）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
支付設置Payment Settings
/api/PaymentConfig/getForStaff讀取門店支付設置（密鑰以掩碼返回）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/PaymentConfig/postForStaff保存門店支付設置（QFPay 商戶參數等）。qfpay_mchidqfpay_codeqfpay_keyqfpay_currencyqfpay_status請求：HTTPS POST；返回統一結構 {code, msg, data}。
打印機Printers
/api/Printer/getInfoByIdForStaff打印機詳情。printer_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Printer/getListForPageForStaff打印機分頁列表（type：1 前廳收據 2 後廚標籤）。pagerowskeywordtypestatus請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Printer/postEditForStaff新增／編輯打印機（雲打印參數、綁定菜品）。printer_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Printer/postDeleteForStaff刪除打印機。printer_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Printer/getCloudDefaultsForStaff雲打印默認模板與參數。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Printer/getCloudDevicesForStaff查詢雲打印平台在線設備。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Printer/postTestPrintForStaff發送測試頁。printer_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
員工Staff
/api/Staff/getInfoForStaff當前登入員工資料。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Staff/getInfoByIdForStaff按 ID 讀取員工資料。staff_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Staff/getListForPageForStaff員工分頁列表。pagerowskeywordstatus請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Staff/postEditForStaff新增／編輯員工（角色、門店歸屬）。staff_id請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/Staff/postModifyPasswordForStaff（說明整理中）old_passwordnew_password請求：HTTPS POST；返回統一結構 {code, msg, data}。
顧客Customers
/api/User/getInfo當前顧客資料（積分、標籤）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。
/api/User/getStoreListForPageForOrder顧客可下單的門店列表。pagerows請求：HTTPS POST；返回統一結構 {code, msg, data}。
文件上傳Upload
/api/Upload/uploadImageForStaff上傳圖片（菜品圖、店鋪圖；自動壓縮並生成縮圖）。（無顯式參數，登錄態與請求體為準）
請求：HTTPS POST；返回統一結構 {code, msg, data}。