Ingestion (고급) API
기본 인제스션 흐름은 Ingestion 을 참조하세요. 본 문서는 CSV 스테이징, 인제스션 파이프라인/실행, 내부 콜백 서브 API를 다룹니다.
CSV 인제스션
prefix: /api/v1/ingestion/csv — CSV 미리보기 → 스테이징 → 커밋 흐름.
| Method | Path | 설명 |
|---|---|---|
| POST | /api/v1/ingestion/csv/preview | CSV 미리보기(스키마 추론) |
| POST | /api/v1/ingestion/csv/staging/{staging_id}/repreview | 스테이징 재미리보기 |
| POST | /api/v1/ingestion/csv/commit | 커밋(Iceberg 적재) |
| GET | /api/v1/ingestion/csv/staging/{staging_id} | 스테이징 상태 |
| DELETE | /api/v1/ingestion/csv/staging/{staging_id} | 스테이징 삭제 |
인제스션 파이프라인 & 실행
prefix: /api/v1 — 문서 수집 파이프라인 정의(/ingestion-pipelines)와 실행 이력(/ingestion-runs). UI 가이드는 Ingestion Runs 참조.
| Method | Path | 설명 |
|---|---|---|
| POST | /api/v1/ingestion-pipelines | 파이프라인 생성 |
| GET | /api/v1/ingestion-pipelines | 목록 |
| PUT | /api/v1/ingestion-pipelines/{pipeline_id} | 수정 |
| DELETE | /api/v1/ingestion-pipelines/{pipeline_id} | 삭제 |
| POST | /api/v1/ingestion-pipelines/{pipeline_id}/runs | 실행 트리거 |
| GET | /api/v1/ingestion-runs | 실행 목록 |
| GET | /api/v1/ingestion-runs/auto-retry-candidates | 자동 재시도 후보 |
| GET | /api/v1/ingestion-runs/{run_id} | 실행 상세 |
| GET | /api/v1/ingestion-runs/{run_id}/items | 실행 항목 |
| POST | /api/v1/ingestion-runs/{run_id}/retry | 재시도 |
| POST | /api/v1/ingestion-runs/{run_id}/cancel | 취소 |
내부 (service-to-service)
prefix: /api/v1/ingestion/internal — X-Internal-Token 인증, 수집 워커 콜백 전용: create-record, persist-chunks, run-items/{item_id}/status (3개).
인증
JWT Bearer(외부) 또는 X-Internal-Token(internal).