跳至主要内容

快速開始

歡迎使用 LifeERP 開發者中心。本頁帶你在五分鐘內完成第一支 API 呼叫：從取得憑證、簽發存取權杖（JWT），到查詢一筆訂單。

:::info 這是什麼 LifeERP 開放 API 讓你的系統（電商平台、ERP、WMS、客服工具）能直接與LifeCOM 的訂單管理系統（OMS）整合 —— 自動建立訂單、查詢庫存、接收物流託運單與 webhook 通知，無需人工進後台操作。 :::

你會用到的​

項目說明
Base URLhttps://oms.lifecom.com.tw（正式環境；測試環境請洽技術窗口取得）
憑證ClientId + CheckValue（由 LifeCOM 開通，請勿外洩）
認證方式Bearer JWT（透過 getToken 端點簽發，有效期內重複使用）
資料格式請求與回應皆為 application/json，欄位採 表.欄位 命名（例：orders.orders_status）

三步驟串接​

步驟 1 — 取得 API 憑證​

向 LifeCOM 技術窗口（service@lifecom.com.tw）申請開通，你會拿到一組:

  • ClientId：你的識別碼，例如 lifecom
  • CheckValue：簽章驗證值，例如 <YOUR_CHECK_VALUE>

這組憑證等同密碼，請存放於後端環境變數，不要寫進前端或版控。

步驟 2 — 簽發存取權杖（Token）​

呼叫 POST /api/v1/token/getToken，用憑證換取 access_token：

curl -X POST https://oms.lifecom.com.tw/api/v1/token/getToken \
  -H "Content-Type: application/json" \
  -d '{
    "ClientId": "lifecom",
    "CheckValue": "<YOUR_CHECK_VALUE>"
  }'

回應：

{
  "done": true,
  "msg": "ok",
  "retval": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

把 retval.access_token 留著，接下來每支 API 都要帶它。完整流程與權杖刷新策略請見 認證說明。

步驟 3 — 送出第一支 API​

帶上 Authorization: Bearer <access_token>，查詢狀態為「已成立」的訂單：

curl -X POST https://oms.lifecom.com.tw/api/v2/default/apiOrderList/searchList \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -d '{
    "orders.orders_status": "7"
  }'

成功的話，你會收到符合條件的訂單清單。各端點的完整欄位、可填值與線上試打介面，請見 V2 API 參考。

下一步​

:::tip 線上試打提醒 在 API 參考頁的「Try it out」中，先到右上方 Authorization 區塊填入你的 Bearer Token，之後即可直接在瀏覽器送出真實請求並看到回應。 :::