INITIAL CHART API SERVER

초진차트 생성을 위한 외부 연동 API 사용 안내

Base URL

http://localhost:9089

API 사용방법

GET /health

API 서버가 정상 동작 중인지 확인합니다.

입력: 없음

POST /v1/structured/upload

정형화된 JSON 파일을 서버에 업로드합니다.

입력: multipart/form-data의 file 항목에 JSON 파일 전달

POST /v1/soap/extract

지정한 정형화 JSON 파일에서 SOAP/H 정보를 추출합니다.

입력: input_path - 추출 대상 JSON 파일 경로

POST /v1/soap/delete

현재 ChromaDB에 저장된 SOAP/H 레코드를 전체 삭제합니다.

입력: 없음

POST /v1/soap/store

SOAP/H 추출 결과 JSON 파일의 레코드를 ChromaDB에 저장합니다.

입력: json_path - 저장할 SOAP/H JSON 파일 경로

GET /v1/soap/records

ChromaDB에 저장된 SOAP/H 레코드를 조건에 따라 조회합니다.

입력 파라미터

soap: str | list[str] | None
category: str | list[str] | None
source_type: str | list[str] | None
has_data: bool | None
1. soap / category
입력 값을 하나만 지정하거나 두 개 이상 지정할 수 있습니다.

soap = "S" : S인 값만 조회
soap = ["S", "O"] : S 또는 O인 값 조회
soap = None : soap 조건 없이 전체 값 조회

category도 동일한 방식으로 사용할 수 있습니다.
2. source_type
데이터 출처를 기준으로 필터링합니다.

source_type = "user" : 사용자 답변으로 업데이트된 레코드만 조회
source_type = None : source_type 조건 없이 전체 값 조회
복수 값을 전달하는 경우 지정한 source_type 중 하나에 해당하는 레코드를 조회합니다.
3. has_data
has_data = true : 데이터가 있는 레코드만 조회
has_data = false : 데이터가 없는 레코드만 조회
has_data = None : has_data 조건 없이 전체 값 조회
조건 조합
여러 파라미터를 함께 지정하면 각 조건을 모두 만족하는 레코드를 조회합니다.
GET /v1/soap/records/{item_id}

item_id에 해당하는 단일 SOAP/H 레코드를 조회합니다.

Path: item_id - 조회할 레코드 ID

POST /v1/questions/generate

ChromaDB에 저장된 SOAP/H 레코드를 조회하여 추가질문을 생성합니다.

입력: query parameter mode, is_save_prompt_context

ChromaDB에서 SOAP/H 레코드를 조회하여, SOAP가 S 또는 O이고 has_data=false인 항목만 대상으로 사용자 질문을 생성합니다. mode (simple/context/summary/focus)에 따라 질문생성 추가프롬프트를 생성하며 디폴트는 focus 모드입니다. is_save_prompt_context = true 이면 프롬프트를 파일로 저장합니다.
POST /v1/answers

추가질문에 대한 사용자 답변을 ChromaDB에 반영하며, 반영하기 전에 연관성을 검증합니다.

입력: item_id, medi_info, question을 포함한 답변 목록