collected
collected API, 엔드포인트 8개 (자동 생성)
수집 데이터: 테넌트의 엣지가 모은 파일·레코드·추론 결과를 장비를 가로질러 조회합니다. 파일은 업로드 때 dataset_id 를 주지 않은 것이며 데이터셋과 별개로 보관됩니다. 레코드와 추론 결과는 보존 기간 뒤 지워지는 조회 창입니다. 사용자 세션 인증이며 디바이스 토큰으로는 부를 수 없습니다.
GET /api/v1/collected/files
GET/api/v1/collected/files
수집 파일 목록
테넌트의 엣지가 데이터셋 지정 없이 올린 파일을 나열합니다 (VIEW).
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
device_id | query | string? | ||
collector | query | string? | ||
kind | query | string? | ||
received_from | query | string (date-time)? | ||
received_to | query | string (date-time)? | ||
page | query | integer | ||
page_size | query | integer? | ||
q | query | string? | 이름 부분 일치 검색 | |
sort | query | string? | 정렬 키 | |
order | query | string | asc | desc |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/collected/files/{file_id}
GET/api/v1/collected/files/{file_id}
수집 파일 상세
수집 파일 한 건과 그 메타 전체를 돌려줍니다 (VIEW).
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
file_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
DELETE /api/v1/collected/files/{file_id}
DELETE/api/v1/collected/files/{file_id}
수집 파일 삭제
파일 객체를 지운 뒤 행을 지웁니다 (DATASET_WRITE). 되돌릴 수 없습니다.
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
file_id | path | string | ✓ |
응답
| 상태 | 설명 |
|---|---|
| 204 | Successful Response |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/collected/files/{file_id}/content
GET/api/v1/collected/files/{file_id}/content
수집 파일 내용
원본 바이트를 스트리밍합니다 (VIEW).
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
file_id | path | string | ✓ | |
download | query | boolean |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
POST /api/v1/collected/files:delete
POST/api/v1/collected/files:delete
수집 파일 일괄 삭제
여러 파일을 한 번에 지웁니다 (DATASET_WRITE, 최대 200건).
요청 본문: application/json, BulkDelete
| 필드 | 형식 | 필수 | 설명 |
|---|---|---|---|
ids | string[] | ✓ | Ids |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/collected/summary
GET/api/v1/collected/summary
수집 데이터 요약
파일 수·용량과 장비별·수집기별·종류별 집계 (VIEW).
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
GET /api/v1/collected/records
GET/api/v1/collected/records
수집 레코드 (테넌트 전체)
테넌트의 모든 장비가 올린 구조화 레코드를 최신순으로 (VIEW, 커서).
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
device_id | query | string? | ||
kind | query | string? | ||
ts_from | query | string (date-time)? | ||
ts_to | query | string (date-time)? | ||
cursor | query | string? | ||
limit | query | integer |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |
GET /api/v1/collected/inference
GET/api/v1/collected/inference
추론 결과 (테넌트 전체)
테넌트의 모든 장비가 올린 추론 결과를 최신순으로 (VIEW, 커서).
파라미터
| 이름 | 위치 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
device_id | query | string? | ||
model | query | string? | ||
ts_from | query | string (date-time)? | ||
ts_to | query | string (date-time)? | ||
cursor | query | string? | ||
limit | query | integer |
응답
| 상태 | 설명 |
|---|---|
| 200 | Successful Response (object) |
| 422 | Validation Error (HTTPValidationError) |