개요 - Factagora

변경 이력이란?

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

버전 체계

Semantic Versioning 규칙에 따라 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`	보안 취약점 대응