Ingestion
파일 업로드, 청킹 정책 관리, 외부 파서 등록을 위한 데이터 수집 API입니다. 다양한 파일 형식(PDF, DOCX, HWP, XLSX 등)을 지원합니다.
엔드포인트
POST /api/v1/ingestion/upload
설명: 파일을 업로드하고 수집합니다. (HTTP 201)
요청: multipart/form-data로 파일을 전송합니다.
GET /api/v1/ingestion/files
설명: 수집된 파일 목록을 반환합니다.
GET /api/v1/ingestion/files/{file_id}
설명: 특정 수집 파일의 상세 정보를 반환합니다.
DELETE /api/v1/ingestion/files/{file_id}
설명: 수집된 파일을 삭제합니다.
POST /api/v1/ingestion/policies
설명: 청킹 정책을 생성합니다. (HTTP 201)
요청 본문:
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| name | string | Y | 정책 이름 |
| chunk_size | int | Y | 청크 크기 |
| overlap | int | N | 오버랩 크기 |
GET /api/v1/ingestion/policies
설명: 청킹 정책 목록을 반환합니다.
PUT /api/v1/ingestion/policies/{policy_id}
설명: 청킹 정책을 수정합니다.
DELETE /api/v1/ingestion/policies/{policy_id}
설명: 청킹 정책을 삭제합니다.
POST /api/v1/ingestion/external-parsers
설명: 외부 파서를 등록합니다. (HTTP 201)
GET /api/v1/ingestion/external-parsers
설명: 등록된 외부 파서 목록을 반환합니다.
인증
JWT Bearer 토큰이 필요합니다.
에러 코드
| 코드 | 설명 |
|---|---|
| 400 | 지원하지 않는 파일 형식 또는 잘못된 요청 |
| 404 | 파일 또는 정책을 찾을 수 없음 |
| 500 | 파일 업로드 또는 파싱 실패 |