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] | Nonecategory: str | list[str] | Nonesource_type: str | list[str] | Nonehas_data: bool | None
1. soap / category
입력 값을 하나만 지정하거나 두 개 이상 지정할 수 있습니다.
입력 값을 하나만 지정하거나 두 개 이상 지정할 수 있습니다.
soap = "S" : S인 값만 조회soap = ["S", "O"] : S 또는 O인 값 조회soap = None : soap 조건 없이 전체 값 조회category도 동일한 방식으로 사용할 수 있습니다.
2. source_type
데이터 출처를 기준으로 필터링합니다.
복수 값을 전달하는 경우 지정한 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을 포함한 답변 목록