API 변경 내역

Living Security Public API는 날짜 기반 계약 버전(YYYY-MM-DD)을 사용합니다. 게시된 OpenAPI 문서에는 계약 버전이 info["x-contract-version"]로 포함되어 있으며, 각 작업은 수명 주기 단계를 x-lifecycle-stage(preview, compatibility 또는 ga)로 선언합니다.

• 최신 사양은 항상 /v1-reference/openapi-v1.json에서 확인할 수 있습니다.
• 버전별 참조 스냅샷은 /v1-reference/openapi/<version>.json에서 확인할 수 있습니다. 예: /v1-reference/openapi/2026-07-01.json

하위 호환성을 유지하는 추가적인 변경 사항(새 작업, 새 선택 필드)은 현재 계약 버전에 포함되어 제공됩니다. 새 계약 버전은 호환되지 않는 변경 사항이 있을 때만 게시되며, 변경 내용과 마이그레이션 방법을 설명하는 항목이 이 페이지에 함께 추가됩니다.

​

문서 업데이트

2026-08-25 — /v1 가이드와 OpenAPI servers 목록에 현재 운영 중인 미국 및 EU 리전 호스트가 명시되었습니다. 이는 문서를 명확하게 보완한 것이며, 계약 버전은 변경되지 않았습니다. 리전을 참조하십시오.

​

2026-07-01

/v1 Public API는 이 계약 버전을 지원합니다. Living-Security-Version: 2026-07-01를 사용하여 버전을 고정하거나, 서비스 계정에 지정된 기본 버전을 사용하십시오. 첫 번째 요청은 API 빠른 시작을, API 키와 OAuth는 인증을, 올바른 호스트는 리전을 참조하십시오.

​

2026-08-05

이 날짜는 별도의 레거시 /api/v1 호환성 계약을 나타냅니다. 새로운 /v1 API의 Living-Security-Version 값이 아닙니다.

• 사람들: 조직 구성원을 검색하고(GET /people/search) 특정 사용자의 멤버십을 조회합니다(GET /people/{personId}/membership).
• API 액세스 키: API 액세스 키를 생성, 조회, 교체 및 폐기합니다(POST /access-keys, GET /access-keys, POST /access-keys/{id}/rotate, DELETE /access-keys/{id}).

이 버전의 모든 작업은 compatibility 수명 주기 단계로 게시됩니다. 인증, 페이지 매김 및 오류 처리는 Public API 개요를, 이 계약이 발전하는 방식은 호환성 및 지원 중단 정책을 참조하십시오.