LightUp 第三方 API 契約已定案・端點已上線 v1.0.0 · 707394544381

變更紀錄

本頁記錄對外契約的變更。棄用至少 90 天前公告(見版本與棄用)。

目前契約版本:1.0.0

來源 commit:707394544381e2463650e138e6a62174e06c9861

1.0.0(2026-11-06:流量報表轉為預覽)

契約版本仍是 1.0.0。 新增操作不升版(見版本與棄用)。

1.0.0(2026-11-06:報表能力依領域拆開)

契約版本仍是 1.0.0。 新增規劃中的能力不升版(見版本與棄用)。

1.0.0(2026-10-30:公布完整能力目錄,79 項規劃中)

契約版本仍是 1.0.0。 新增規劃中的能力不升版(見版本與棄用)。

1.0.0(2026-10-28:新增客戶的被監護人能力,預覽)

契約版本仍是 1.0.0。 新增操作不升版(見版本與棄用);新增的能力狀態為預覽,不適用正式版的支援與棄用保證。

1.0.0(2026-10-26:標籤寫入與建立標籤由規劃轉為預覽)

契約版本仍是 1.0.0。 能力目錄的狀態轉換不升版(見版本與棄用);兩項能力狀態為預覽,不適用正式版的支援與棄用保證。

1.0.0(2026-10-25:新增客戶基本資料能力,預覽)

契約版本仍是 1.0.0。 新增操作不升版(見版本與棄用);新增的能力狀態為預覽,不適用正式版的支援與棄用保證。

1.0.0(2026-10-19:新增標籤與顧客、LINE 訊息組能力,讀取為預覽、寫入為規劃)

契約版本仍是 1.0.0。 新增操作與新增錯誤代碼不升版(見版本與棄用);新增的讀取能力狀態為預覽,寫入能力狀態為規劃,尚未開放。

1.0.0(2026-10-17:新增訂單能力,預覽)

契約版本仍是 1.0.0。 新增操作與新增錯誤代碼不升版(見版本與棄用);新增的三項能力狀態為預覽,不適用正式版的支援與棄用保證。

1.0.0(2026-10-05:正式版)

API 進入正式版:契約版本由 1.0.0-draft 改為 1.0.0,對外公開。 契約形狀沒有破壞性 變更;從這一版起,版本與棄用的相容政策(加欄位不升版、改語意升 /v2、棄用至少 90 天前公告)完整適用。

1.0.0-draft(2026-10-02:生效改由方案與租戶自助開關決定)

契約形狀沒有變更;變的是 tenant_not_enabled 背後的原因,以及誰能讓它消失。

1.0.0-draft(2026-09-30:端點開放)

端點已上線,本站的「尚未開放」提示同時撤下。契約形狀沒有任何變更,版本號未變。 以下是從「照契約開發」變成「可以真的呼叫」的那幾件事:

1.0.0-draft(2026-09-27 修訂)

登入面(OIDC)的錯誤形狀與 session 生命週期寫進契約,版本號未變。 來源是 Amygdala 的兩支 PR — lightup-rs #1408(第三方 OIDC 登入走租戶登入 v2、psn_ subject、 session 綁定 token)與 #1412(introspection、back-channel logout、RP-initiated logout),以及 #1425(同租戶的第一方 logout 導回、封鎖 IPv4-compatible IPv6)。 ✅ 三支都已合併並於 2026-09-30 上線(見最上方的條目)。本節寫下時它們還沒部署,現在是正式行為。

1.0.0-draft(2026-09-26 修訂)

契約狀態改為 Accepted。 ADR-004 的 D1–D10 已全部實作、審查並合併進平台主線(amygdala 授權與 person extension、third-party gateway、後台整合管理、本文件站),版本號未變。當時端點仍未開放(正式環境的旗標全部關閉)——那是這一天的狀態,端點已於 2026-09-30 開放,見最上方的條目。撤權時限的對外承諾數值仍未定,也不打算對外給數字。

1.0.0-draft(2026-09-23 修訂)

契約草案在審查後的修訂,版本號未變(仍是尚未發布的草案)。

1.0.0-draft

狀態:Proposed(草案)。此版本發布時端點尚未上線(端點於 2026-09-30 開放)。

首次發布的對外契約草案。

首發當時已知的待定項(歷史紀錄)

下表是首發當時的狀態,保留備查;現況見最上方的 2026-09-30 條目。

項目 首發當時 現況
對外 API host 已定案 api.lightup.tech;tunnel ingress 尚未建立 已上線並接受請求
文件網站 host 已定案 developers.lightup.tech 已上線
撤權最大傳播時間 待實測後公布;只承諾「下一個請求生效」 維持不承諾秒數、沒有 SLA
Dashboard「整合」頁 尚未提供;登記與核准暫由人工流程處理 已上線,租戶管理員自助
client_credentials grant 尚未在 token 端點實作,discovery 尚未公告 已實作並在 discovery 公告
代理(delegated profile) 不在 v1 範圍;列為 v2 規劃 仍不在 v1 範圍