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의 filter 10개와 compare를 제거하며, List account members에서 accessCheck를 없애고, Users, Users (beta), User settings API를 제거합니다. 공식 문서는 완전하지만 길어서, '내 버전 × 내 엔드포인트 → 오늘 밤 고칠 호출 → 테스트 방법'을 한 페이지로 보여 주는 도구가 없습니다.

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월 deprecated)는 20240415에서 제거됩니다. getUserFlagSettings, getUserFlagSetting, getExpiringFlagsForUser는 직접 대체가 없습니다.

기능

기능

제품 가설에 기반한 마케팅 포인트입니다 — 수요 검증용이며 정식 사양 약속이 아닙니다.

🧭

버전 노출 점검

정말 20220603에서 돌고 있나요? 헤더 vs 토큰 기본값을 판단하고, 공식 수정 방법 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 키, 코드를 붙여 넣지 마세요. 언제든 수신 거부.