V3 API（開發中）
:::warning 開發中，敬請期待 LifeERP V3 API 正在規劃與開發中，尚未開放。本頁為版本骨架，用以展示文件站的多版本切換能力。正式釋出時間將於本站與電子報公告。 :::
為什麼要有 V3
V3 將在保留 V2 既有能力的前提下，帶來更一致、更現代的開發體驗：
| 主題 | V2（現役） | V3（規劃方向） |
|---|---|---|
| 認證 | Bearer JWT（getToken） | OAuth 2.0 Client Credentials + 短期權杖輪替 |
| 命名 | 表.欄位（如 orders.orders_status） | 巢狀 JSON 資源模型（order.status） |
| 分頁 | 條件式查詢 | 游標式分頁（cursor pagination） |
| 事件 | Digiwin / Callback 個別端點 | 統一 Webhook 事件匯流排與簽章驗證 |
| 錯誤 | done / msg | 標準化 error.code / error.message + HTTP 狀態碼 |
| 版本治理 | — | 明確的棄用政策與遷移指南 |
以上為規劃方向示意，最終設計以正式釋出之規格為準。
遷移與相容性
- V2 在 V3 釋出後仍會持續維運一段過渡期，不會立即停用。
- 我們會提供 V2 → V3 遷移指南 與對照表。
- 你現在用 V2 串接的整合不需要任何變動即可繼續運作。
想搶先參與？
若你有興趣參與 V3 早期測試（Early Access），請來信 service@lifecom.com.tw，並註明目前的 V2 使用情境。
目前請使用 V2 API 參考 進行串接。