> ## Documentation Index
> Fetch the complete documentation index at: https://docs.factagora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 개요

> Factagora Search API의 버전 관리 방식과 변경 이력 기록 범위

## 변경 이력이란?

변경 이력은 각 버전별로 Factagora Search API에서 발생한 주요 변경사항을 기록합니다. API를 사용하는 개발자가 무엇이 바뀌었는지, 기존 코드에 영향이 있는지, 조치가 필요한지를 파악할 수 있도록 작성됩니다.

공개 문서에 등록된 API의 변경사항만 기록하며, 내부 전용 엔드포인트는 제외합니다.

***

## 버전 체계

[Semantic Versioning](https://semver.org/) 규칙에 따라 `MAJOR.MINOR.PATCH` 형식을 따릅니다.

| 구분        | 올리는 조건                                | 예시                                   |
| --------- | ------------------------------------- | ------------------------------------ |
| **MAJOR** | 하위 호환성을 깨는 변경으로, 기존 클라이언트 코드가 동작하지 않음 | 응답 필드 삭제, 엔드포인트 URL 변경, 인증 방식 변경     |
| **MINOR** | 하위 호환성을 유지하는 기능 추가                    | 새 엔드포인트 추가, 선택적 파라미터 추가, 응답에 새 필드 추가 |
| **PATCH** | 하위 호환성을 유지하는 버그 수정                    | 잘못된 응답 데이터 수정, 성능 개선                 |

`0.y.z` 버전은 초기 개발 단계로 무엇이든 변경될 수 있습니다. `1.0.0`부터 공개 API 안정성을 보장합니다.

***

## 기록 대상

아래 엔드포인트의 변경사항을 이 변경 이력에서 관리합니다.

| 엔드포인트                               | 설명               |
| ----------------------------------- | ---------------- |
| `GET /api/v1/fact-search`           | 팩트 검색            |
| `POST /api/v1/fact-checker`         | 팩트 체커            |
| `POST /api/v1/evidence-finder`      | 근거 탐색            |
| `POST /api/v1/deep-research`        | 심층 리서치           |
| `POST /api/v1/timeseries`           | 시계열 데이터 추출       |
| `POST /api/v1/timeseries/file`      | 시계열 데이터 추출 (파일)  |
| `POST /api/v1/causality-graph`      | 인과관계 그래프 추출      |
| `POST /api/v1/causality-graph/file` | 인과관계 그래프 추출 (파일) |
| `POST /api/v1/fingerprint/embed`    | 핑거프린트 삽입         |
| `POST /api/v1/fingerprint/detect`   | 핑거프린트 감지         |

***

## 변경사항 분류

각 릴리스는 아래 분류로 변경사항을 정리합니다.

| 분류           | 의미                |
| ------------ | ----------------- |
| `Added`      | 신규 기능 또는 엔드포인트 추가 |
| `Changed`    | 기존 동작 변경          |
| `Deprecated` | 향후 제거 예정 기능       |
| `Removed`    | 삭제된 기능            |
| `Fixed`      | 버그 수정             |
| `Security`   | 보안 취약점 대응         |