본문으로 건너뛰기

Collection

Deprecation 노트

ccxt / rss source_type 의 신규 생성은 410 Gone 을 반환합니다 (#2532 — intel 1급 승격 #2535, crypto 시세/RSS 정본은 공용 수집기 (관리형) /admin/intel-sources). 구 자동 수집(/collections) 화면은 은퇴했습니다 (#2533) — 이 API 의 소스 정의는 파일·문서 수집 허브(/ingestion)가 소비합니다.

외부 데이터 소스(SMB, SFTP, S3, SharePoint, REST, IMAP, NFS, WebCrawl)에서 데이터를 수집하는 API입니다. 소스 등록, 연결 테스트, 수집 실행 기능을 제공합니다.

엔드포인트​

POST /api/v1/collection/sources​

설명: 새 수집 소스를 등록합니다. (HTTP 201)

GET /api/v1/collection/sources​

설명: 수집 소스 목록을 반환합니다.

GET /api/v1/collection/sources/{source_id}​

설명: 특정 소스의 상세 정보를 반환합니다.

PUT /api/v1/collection/sources/{source_id}​

설명: 소스 설정을 수정합니다.

DELETE /api/v1/collection/sources/{source_id}​

설명: 소스를 삭제합니다.

POST /api/v1/collection/sources/{source_id}/enable​

설명: 소스를 활성화합니다.

POST /api/v1/collection/sources/{source_id}/disable​

설명: 소스를 비활성화합니다.

POST /api/v1/collection/sources/{source_id}/test​

설명: 소스 연결을 테스트합니다.

POST /api/v1/collection/sources/{source_id}/collect​

설명: 즉시 수집을 실행합니다. (HTTP 201)

GET /api/v1/collection/runs​

설명: 수집 실행 이력을 반환합니다.

GET /api/v1/collection/runs/{run_id}​

설명: 특정 실행의 상세 정보를 반환합니다.

GET /api/v1/collection/sources/{source_id}/runs​

설명: 특정 소스의 수집 실행 이력을 반환합니다.

인증​

JWT Bearer 토큰이 필요합니다.

에러 코드​

코드설명
400잘못된 소스 설정
404소스 또는 실행을 찾을 수 없음
500외부 소스 연결 또는 수집 실패