Eine Entscheidungsebene für die Umstellung 20220603 → 20240415 für LaunchDarkly-REST-API-Nutzer, die noch auf 20220603 sind (oder keinen Header senden): Ihre Versions-Konfiguration × die aufgerufenen Endpunkte → Must-Change-Liste + Vorlagen + Users→Contexts-Mapping + Regressions-Checkliste. Kein Ersatz für die offiziellen Docs, kein LaunchDarkly-Connector und keine Verbindung zu LaunchDarkly.
WHO
Platform Engineering, DevOps und Verantwortliche für interne Tools, deren Teams LaunchDarkly bereits bezahlen und Flags, Segments, Members, Custom Roles oder Access Tokens über die REST API verwalten (Skripte, CI, Admin-Backoffice, Generated Client) — noch auf LD-API-Version: 20220603 festgelegt oder ohne Header und abhängig von der Default-Version eines alten Access Tokens.
PROBLEM
20220603 erreicht am 31. Dezember 2026 das End of Life; ab 1. Januar 2027 müssen alle Kunden 20240415 nutzen. 20240415 paginiert List access tokens, List custom roles, List feature flags, List segments und Get workflows; entfernt 10 Filter und compare aus List feature flags; streicht accessCheck bei List account members; und entfernt die Users-, Users-(beta)- und User-settings-APIs. Die offiziellen Docs sind vollständig, aber lang — es fehlt ein einseitiges Tool „meine Version × meine Endpunkte → was heute Nacht zu fixen ist → wie testen“.
SOLUTION
5 Fragen ankreuzen → personalisierte Must-Change-Liste, limit/offset-Vorlagen als curl und Pseudocode, das offizielle Users→Contexts-Mapping und eine Regressions-Checkliste, dazu eine Warteliste. Fragt nie nach LaunchDarkly-Access-Tokens, SDK-Keys oder Quellcode; kein LaunchDarkly-Connector.
RESULT
Vor dem 31.12.2026 laufen alle Skripte, CI-Jobs und Backoffice-Tools auf 20240415: Sie wissen, welche Calls brechen, wie die Pagination-Schleife aussieht, welcher Contexts-Endpunkt jeden Users-Call ersetzt und was vor dem Release zu testen ist — statt am 1.1.2027 Brände zu löschen, wenn Release-Gates, Sync-Jobs und Audit-Reports gleichzeitig ausfallen.
Offizielles Users → Contexts-Mapping
| Entfernter Users- / User-settings-Endpunkt | Ersatz (laut Migration Guide) |
|---|
getSearchUsers | searchContextInstances |
|---|
getUsers | searchContexts |
|---|
getUser | getContextInstances |
|---|
deleteUser | deleteContextInstances |
|---|
getUserAttributeNames | getContextAttributeNames |
|---|
putFlagSetting | putContextFlagSetting |
|---|
patchExpiringFlagsForUser | patchExpiringTargets (semantic patch addExpiringTarget) |
|---|
getUserFlagSettings | Kein direkter Ersatz evaluateContextInstance kann in manchen Situationen gleichwertig sein. |
|---|
getUserFlagSetting | Kein direkter Ersatz Erwägen Sie die flag variation evaluation details des SDK. |
|---|
getExpiringFlagsForUser | Kein direkter Ersatz |
|---|
Die Users-, Users-(beta)- und User-settings-APIs (seit Mai 2023 deprecated) werden in 20240415 entfernt. getUserFlagSettings, getUserFlagSetting und getExpiringFlagsForUser haben keinen direkten Ersatz.