LdApiEOL · ウェイトリスト

12/31 までに LaunchDarkly API 20220603 から移行——壊れる呼び出しと再テスト項目を把握

5 つの質問に答えるだけ——LD-API-Version を明示しているか、アクセストークンの作成時期、呼び出している list エンドポイント、Users/User settings API をまだ使っているか、raw HTTP か generated client か。20240415 向けの必須変更リスト、ページネーションのテンプレート、Users→Contexts 対応表、回帰チェックリストを取得。LaunchDarkly コネクタではありません——トークン、SDK キー、コードを貼る必要はありません。

LaunchDarkly の migration guide によると、API バージョン 20220603 は 2026年12月31日に EOL。2027年1月1日から全顧客が 20240415 の使用を求められます。

市場検証ページ · 無料ウェイトリスト · 偽のユーザー数なし · LaunchDarkly とは提携していません · トークン・SDK キー・コード不要

課題

2026年12月31日:API バージョン 20220603 の EOL

LaunchDarkly の REST API migration guide によると、REST API バージョン 20220603 は 2026年12月31日に EOL を迎え、それ以降はアクセスできなくなります。2027年1月1日からは全顧客が 20240415 の使用を求められます。20240415 は破壊的変更を含むバージョンです:複数の list エンドポイントがページネーション化され(最初のページだけ読むと黙ってデータが欠落)、List feature flags からは filter と compare パラメータが削除され、Users、Users (beta)、User settings API は完全に削除されます。実際のバージョンは各リクエストの LD-API-Version ヘッダーで決まり、設定していない場合はアクセストークン作成時に設定されたバージョンで決まります。

Before

  • migration guide 全文を読み各リポジトリを grep
  • 移行後 List feature flags が 20 件しか返らず、クリーンアップスクリプトが残りを黙って取りこぼす
  • 1/1 に Users API が消え、代替のない呼び出しがあると気づく

After

  • 5 問に答えるだけで自分に関係する変更だけ
  • ページネーションテンプレート+上限(flags 100、segments 50)+件数比較テスト
  • 直接の代替がない 3 エンドポイントを事前に明示する Users→Contexts 対応表

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 のまま(またはヘッダー未設定)の LaunchDarkly REST API 利用者向けの 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 に固定したまま、またはヘッダーを設定せず古いアクセストークンの既定バージョンに依存しているチーム。

PROBLEM

20220603 は 2026年12月31日に EOL、2027年1月1日から全顧客が 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 が削除されます。公式ドキュメントは網羅的ですが長く、「自分のバージョン × 呼び出すエンドポイント → 今夜直すべき呼び出し → テスト方法」を 1 ページで示すツールがありません。

SOLUTION

5 問にチェック → パーソナライズされた必須変更リスト、limit/offset の curl と疑似コードのテンプレート、公式の Users→Contexts 対応表、回帰チェックリスト、そしてウェイトリスト。LaunchDarkly のアクセストークン、SDK キー、ソースコードは一切求めません。LaunchDarkly コネクタではありません。

RESULT

2026-12-31 までに、すべてのスクリプト/CI/バックオフィスを 20240415 に移行:どの呼び出しが壊れるか、ページネーションのループをどう追加するか、各 Users 呼び出しをどの 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年5月に非推奨)は 20240415 で削除されます。getUserFlagSettings、getUserFlagSetting、getExpiringFlagsForUser には直接の代替がありません。

機能

機能

プロダクト仮説に基づくマーケティング上のポイントです——需要検証のためのもので、正式な仕様の約束ではありません。

🧭

バージョン影響チェック

本当に 20220603 で動いていますか?ヘッダーとトークン既定値を判定し、公式の 2 つの修正方法と 21.x+ クライアントの注意点を提示。

📋

パーソナライズされた必須変更リスト

ページネーション化されたエンドポイント、List feature flags で削除された filter と compare、members の accessCheck、teams の expand 制限。

🔁

ページネーションテンプレート

エンドポイントごとに正しい上限を使った limit/offset ループ。トークンは $LD_API_TOKEN プレースホルダーとしてのみ表示。

🔀

Users → Contexts 対応表

公式の 1 対 1 の置き換えと、「直接の代替なし」の警告。

⏳

回帰チェックリスト+カウントダウン

staging 優先の切り替え手順と、2026年12月31日までの残り日数。

ウェイトリストに登録

仕組み

仕組み

ウェイトリスト段階のプロダクト仮説に沿った 3 ステップ。

  1. 1

    5 つの質問に答える

    LD-API-Version の有無 · トークンの作成時期/既定バージョン · 呼び出す list エンドポイント · Users/User settings API · raw HTTP か generated client か。

  2. 2

    必須変更リストを取得

    新たにページネーション化されたエンドポイント(既定ページサイズと limit 上限付き)、削除された filter、公式の Users→Contexts 対応(直接の代替がないものも明示)。すべて公式ドキュメントへのリンク付き。

  3. 3

    テンプレートをコピーし回帰チェック

    limit/offset の curl と疑似コード、LD-API-Version: 20240415 の修正、staging→prod チェックリスト——トークン・SDK キー・コード不要。

ウェイトリストに登録

ユースケース

こんなチーム向け

思い当たる状況があれば、ウェイトリストに登録して検証にご協力ください。

CI のリリースゲートで flags を一覧取得

GET /api/v2/flags/{projectKey} をページングなしで呼び、flag が 20 件超 → 移行後は最初のページしか見えません。ページネーションループのテンプレート(limit 上限 100)と件数比較テストが必要。

status/hasExperiment などの filter を使う flag クリーンアップスクリプト

これらの filter は 20240415 で削除されます。必須変更リストと「クライアント側でフィルタする」回帰項目が必要。

members/custom roles/access tokens を一覧する社内権限バックオフィス

members の accessCheck はサポートされなくなり、custom roles と access tokens はページネーション化。エンドポイントごとのリストが必要。

Users API/User settings API を呼び続ける古い連携

Users→Contexts 対応表と、直接の代替がない 3 エンドポイントの事前把握が必要。

ヘッダーを設定せず古いトークンの既定バージョンに依存するスクリプト

実際のバージョンを判定し、「全リクエストにヘッダーを追加」か「新しいトークンに切り替え」かを決める必要がある。

generated client library を利用

21.x+ へのアップグレードを確認し、型とページネーションの挙動を回帰テストする必要がある。

よくある質問

よくある質問

LdApiEOL は LaunchDarkly 公式ツールですか?

いいえ。独立したツールで、LaunchDarkly とは提携・承認関係にありません。情報はすべて LaunchDarkly の公開ドキュメントをリンク付きで引用しています。

公式 migration guide との違いは?

公式はすべての変更を列挙。私たちはチェックしたバージョン設定とエンドポイントに絞り、必須変更リスト・テンプレート・回帰チェックリストを出します。

Support チケットやコンサルタントとの違いは?

Support は個別の問い合わせに回答し、コンサルタントはプロジェクト全体を請け負います。私たちは軽量なセルフサービスの静的ツールで、検証期間のウェイトリストは無料です。

LD-API-Version を設定したことがありません。影響はありますか?

その場合、バージョンはアクセストークン作成時に設定されたバージョンで決まります。20220603 以前なら影響の可能性があります。LaunchDarkly はすべてのリクエストでヘッダーを明示することを推奨しています。

ヘッダーを変えるだけで十分?

ヘッダー変更(または 20240415 の新トークン作成)はバージョン切り替えのみ。ページネーション、削除された filter、Users API の削除はコード修正と再テストが必要です。

LaunchDarkly SDK も変更が必要?

公式ガイドによると、今回 SDK の非推奨化はなく、REST API のみが対象です。

アクセストークン、SDK キー、コードを求めますか?

いいえ。求めず、保持せず、保存しません。LaunchDarkly アカウントにも接続しません。

API 呼び出しやコード修正をしてくれますか?

いいえ。MVP は静的な質問票+必須変更リスト+テンプレート+チェックリスト+ウェイトリストです。

Early Access はいつ?

ウェイトリストからメールで順次ご案内。偽の公開日は出しません。

料金は?

小規模な移行準備チェックまたはチーム席課金を想定しています。正式な料金はローンチのお知らせでご案内します。ウェイトリストは無料です。

ウェイトリストに登録

ウェイトリスト

ウェイトリストに登録

仕事用メールを登録して LdApiEOL の Early Access とローンチ情報を受け取りましょう。チェックボックスと選択肢のみ——どの欄にも LaunchDarkly のアクセストークン、SDK キー、モバイルキー、コードを貼らないでください。

呼び出すエンドポイント (任意)
クライアント種別 (任意)

ウェイトリスト/Early Access/ローンチ通知のみに使用。LaunchDarkly のアクセストークン、SDK キー、コードは貼らないでください。いつでも解除可能。