加入等候名單

LdApiEOL · 等候名單

12/31 前離開 LaunchDarkly API 20220603——知道哪些呼叫會壞、要重測什麼

回答 5 題——是否設了 LD-API-Version、access token 多舊、呼叫哪些 list 端點、是否還用 Users／User settings API、自建 HTTP 或 generated client。取得 20240415 必改清單、分頁樣板、Users→Contexts 對照與回歸 checklist。不是 LaunchDarkly 連線器——從不要求貼 token、SDK key 或程式碼。

加入等候名單 看看 5 題檢查如何運作

依 LaunchDarkly 官方 migration guide：API 版本 20220603 於 2026 年 12 月 31 日結束生命週期；2027 年 1 月 1 日起所有客戶必須使用 20240415。

市場驗證頁 · 免費等候名單 · 無假用戶數 · 與 LaunchDarkly 無隸屬關係 · 從不要求 token／SDK key／程式碼

問題

2026-12-31：API 版本 20220603 結束生命週期

依 LaunchDarkly 官方《REST API migration guide》：20220603 REST API 版本於 2026 年 12 月 31 日結束生命週期，之後將無法再存取；2027 年 1 月 1 日起所有客戶必須使用 20240415。20240415 是破壞性版本：多個 list 端點改為分頁（只拿第一頁就會「靜默少資料」）、List feature flags 移除多個 filter 與 compare 參數，Users、Users (beta)、User settings API 完全移除。你實際跑的版本由每個請求的 LD-API-Version header 決定——若從沒設，則由 access token 建立時設定的版本決定。

Before

  • 讀完整份 migration guide，再手動 grep 每個 repo 的 header 與端點
  • 升版後 list flags 只回 20 筆，清理腳本靜默漏掉其餘
  • 2027-01-01 才發現 Users API 已移除，且有些呼叫無替代

After

  • 回答 5 題 → 只看到跟你有關的必改項
  • 分頁樣板＋上限（flags 100、segments 50）＋筆數比對測試
  • Users→Contexts 對照表，提前標出 3 個無直接替代端點

20240415 改了什麼（依官方 migration guide）

端點變更內容預設頁大小limit 上限
List access tokens改為分頁
用 limit／offset 翻頁，直到 items 為空、或 offset 大於 totalCount。		251000
List custom roles改為分頁
用 limit／offset 翻頁，直到 items 為空、或 offset 大於 totalCount。		201000
List feature flags改為分頁
用 limit／offset 翻頁。移除 10 個 filter 與 compare 參數；environments 欄位只有在以環境過濾時才回傳。		20100
List segments改為分頁
用 limit／offset 翻頁，直到 items 為空、或 offset 大於 totalCount。		2050
Get workflows改為分頁
用 limit／offset 翻頁。回應不再有 _conflicts 欄位。		20200
List account members非新改分頁
不再支援 accessCheck filter；limit 上限 1000。		—1000
List teams非新改分頁
expand 不再支援 projects 或 roles；limit 上限 100。		—100

20240415 從 List feature flags 移除（依官方 migration guide）：

codeReferencescontextKindTargetedcontextKindsEvaluatedfollowerIdhasDataExporthasExperimentsegmentTargetedstatustargetingtargetingModifiedDatecompare

來源：LaunchDarkly《REST API migration guide: 20220603 to 20240415》（2026-09-27 核對）。使用 generated client library 者需升級到 21.x 或更新。請以官方頁面為準。

加入等候名單

解決方案

LdApiEOL 做什麼

給仍在 20220603（或沒設 header）的 LaunchDarkly REST 使用者的 20220603→20240415 就緒決策層：你的版本設定 × 你呼叫的端點 → 必改清單＋樣板＋Users→Contexts 對照＋回歸清單。不是官方文件替代品，也不是 LaunchDarkly 連線器；與 LaunchDarkly 無隸屬關係。

WHO

團隊已付費使用 LaunchDarkly，並以 REST API（自建腳本、CI、管理後台、generated client）管理 flags／segments／members／custom roles／access tokens 的平台工程、DevOps、內部工具負責人；仍釘 LD-API-Version: 20220603，或根本沒設 header、依賴舊 access token 的預設版本。

PROBLEM

20220603 於 2026-12-31 結束生命週期；2027-01-01 起所有客戶必須使用 20240415。20240415 將 List access tokens、List custom roles、List feature flags、List segments 與 Get workflows 改為分頁；List feature flags 移除 10 個 filter 與 compare；List account members 移除 accessCheck；Users、Users (beta)、User settings API 完全移除。官方文件完整但長，缺「我用哪一版 × 呼叫哪些端點 → 今晚先改哪幾個呼叫 → 怎麼測」的一頁式決策工具。

SOLUTION

勾選 5 題 → 個人化必改清單、limit／offset 的 curl 與偽碼樣板、官方 Users→Contexts 對照表、回歸 checklist，並提供 waitlist。從不要求 LaunchDarkly access token、SDK key 或原始碼；不是 LaunchDarkly 連線器。

RESULT

在 2026-12-31 前把所有腳本／CI／後台切到 20240415：知道哪些呼叫會壞、分頁迴圈怎麼補、Users API 換成哪個 Contexts 端點、上線前要測哪些——而不是 2027-01-01 早上發布閘、同步作業、稽核報表一起掛掉才救火。

官方 Users → Contexts 對照

被移除的 Users／User settings 端點替代（依官方 migration guide）
getSearchUserssearchContextInstances
getUserssearchContexts
getUsergetContextInstances
deleteUserdeleteContextInstances
getUserAttributeNamesgetContextAttributeNames
putFlagSettingputContextFlagSetting
patchExpiringFlagsForUserpatchExpiringTargets （semantic patch addExpiringTarget）
getUserFlagSettings無直接替代
部分情境可用 evaluateContextInstance。
getUserFlagSetting無直接替代
考慮 SDK 的 flag variation evaluation details。
getExpiringFlagsForUser無直接替代

Users、Users (beta)、User settings API（2023-05 棄用）在 20240415 完全移除。getUserFlagSettings、getUserFlagSetting、getExpiringFlagsForUser 無直接替代。

功能特色

功能特色

以下為產品假設中的行銷重點——用於需求驗證，非正式規格承諾。

🧭

版本曝險判斷

你真的在 20220603 嗎？header vs token 預設，附兩條官方修法與 21.x+ client 提示。

📋

個人化必改清單

分頁端點、List feature flags 被移除的 filter 與 compare、members accessCheck、teams expand 限制。

🔁

分頁樣板

每個端點正確上限的 limit／offset 迴圈；token 只以 $LD_API_TOKEN 佔位。

🔀

Users→Contexts 對照

官方逐條替代，並標示「無直接替代」。

⏳

回歸清單＋倒數

staging 優先的切換步驟與距 2026-12-31 剩餘天數。

加入等候名單

如何運作

如何運作

與等候名單階段產品假設一致的三步驟。

  1. 1

    回答 5 題

    是否顯式設 LD-API-Version · token 年代／預設版本 · 呼叫的 list 端點 · Users／User settings API · 自建 HTTP 或 generated client。

  2. 2

    取得必改清單

    新分頁端點（含預設頁大小與 limit 上限）、被移除的 filter、官方 Users→Contexts 對照（含無直接替代者），每項附官方來源連結。

  3. 3

    複製樣板、跑回歸清單

    limit／offset 的 curl 與偽碼、LD-API-Version: 20240415 修法、staging→prod 回歸清單——從不要求 token、SDK key 或程式碼。

加入等候名單

使用情境

適合誰

如果以下情境很熟悉，歡迎加入等候名單協助我們驗證。

CI 發布閘列 flags 做檢查

GET /api/v2/flags/{projectKey} 沒帶分頁、flag 數 > 20 → 升版後只看到第一頁；需要分頁迴圈樣板（limit 上限 100）與筆數比對測試。

Flag 清理腳本用 status／hasExperiment 等 filter

這些 filter 在 20240415 移除；需要必改清單與「改在客戶端過濾」的回歸項。

內部權限後台列 members／custom roles／access tokens

members 的 accessCheck 不再支援、custom roles 與 access tokens 改分頁；需要逐端點清單。

舊整合仍呼叫 Users API／User settings API

需要 Users→Contexts 對照，並提前知道哪 3 個端點沒有直接替代。

腳本沒設 header、靠舊 token 預設版本

需要判斷實際版本，並決定「全面加 header」還是「換新 token」。

使用 generated client library

需要確認升到 21.x+ 並回歸型別／分頁行為。

公開訊號

LaunchDarkly 官方文件公開訊號

僅列 LaunchDarkly 官方公開文件——不是客戶推薦、背書或捏造指標。

常見問題

常見問題

LdApiEOL 是 LaunchDarkly 官方工具嗎？

不是。LdApiEOL 為獨立工具，與 LaunchDarkly 無隸屬或背書關係；所有資訊引用 LaunchDarkly 公開文件並附連結。

和官方 migration guide 差在哪？

官方列出全部變更；我們只針對你勾選的版本設定與端點，輸出必改清單、樣板與回歸清單。

和開 Support ticket 或找顧問差在哪？

Support 回答個案、顧問做完整專案；我們是輕量自助靜態工具，驗證期 waitlist 免費。

我從沒設 LD-API-Version，會受影響嗎？

版本會由 access token 建立時設定的版本決定；若是 20220603 或更舊就可能受影響。官方建議每個請求都顯式設 header。

只加 header 就夠了嗎？

加 header（或換新 20240415 token）只是切版；分頁、被移除的 filter、Users API 移除仍需改程式並回歸測試。

LaunchDarkly SDK 也要改嗎？

依官方 guide，此次沒有任何 SDK 被棄用，只影響 REST API。

會要求 access token、SDK key 或程式碼嗎？

不會。從不要求、不持有、不儲存；不連你的 LaunchDarkly 帳號。

會幫我打 API 或改程式嗎？

不會。MVP 是靜態問卷＋必改清單＋樣板＋回歸清單＋waitlist。

搶先體驗何時開始？

等候名單分批以 Email 邀請；不捏造上線日期。

定價？

假設為小額就緒稽核或團隊席位；正式價格以 launch 通知為準。等候名單免費。

加入等候名單

等候名單

加入等候名單

留下工作 Email，取得 LdApiEOL 搶先體驗與上線通知。表單只有勾選與下拉選單——任何欄位都請勿貼 LaunchDarkly access token、SDK key、mobile key 或程式碼。

呼叫的端點 （選填）
用戶端類型 （選填）

僅用於等候名單、搶先體驗與上線通知；請勿貼 LaunchDarkly access token、SDK key 或程式碼；可隨時退訂。