V2 API 參考（現役）
這是 LifeERP 目前正式營運的 API 版本。以下每個 API 群組都由 OpenAPI 規格自動產生，附完整欄位說明與 Try it out 線上試打。
:::tip 開始試打前
- 先到 認證說明 取得
access_token。 - 在任一端點頁面右上的 Authorization 區塊填入 Bearer Token。
- 按 Try it out → Execute 即可送出真實請求。 :::
API 群組
| 群組 | 規格檔 | 內容 | 認證 |
|---|---|---|---|
| Default（主 API） | defaultApi.yaml | 訂單查詢/建立/明細/取消/退貨、庫存、進貨、託運單 | Bearer JWT |
| Digiwin | digiwinApi.yaml | 鼎新物流出貨單、進退貨單推送 | API Key |
| Callback | callbackApi.yaml | 物流/訂單狀態回拋 | API Key |
| BizPro | bizproApi.yaml | BizPro 整合端點 | Bearer JWT |
Base URL
https://oms.lifecom.com.tw
測試環境網址請洽技術窗口
service@lifecom.com.tw。
共通約定
- 所有端點皆為
POST，請求與回應皆application/json。 - 欄位採
表.欄位命名（例：orders.orders_status、view_products_stock.warehouse_no）。 - 區間查詢以
@start/@end後綴表示（例：orders.orders_amt@start）。 - 回應通常含
done（是否成功）、msg（訊息）、retval（資料）三段。
選擇左側選單的任一端點開始瀏覽與試打。