| 용도 | 엔드포인트 |
|---|---|
| 폴더의 아이템 목록 | GET /v1/folders/{folderId}/items |
| 아이템 단건 | GET /v1/items/{itemId} |
아이템 목록 조회
GET /v1/folders/{folderId}/items
count와 items만 반환합니다.
쿼리 파라미터
| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
type | string | 타입 필터: file · text · json | |
search | string | 아이템 이름 부분 검색 | |
sort | string | createdAt | name · type · createdAt |
order | string | desc | asc · desc |
curl "https://client-omni-api.argosidentity.com/v1/folders/fd_dvh8axwowi4v/items?sort=createdAt&order=asc" \
-H "x-api-key: your-api-key-here"
응답
{
"count": 3,
"items": [
{
"id": "item_ieoravdq3jp3",
"folderId": "fd_dvh8axwowi4v",
"type": "text",
"name": "사업자등록증",
"content": "사 업 자 등 록 증\n(법인사업자)\n\n등록번호: 123-45-67890 ...",
"contentType": "text/plain",
"sizeBytes": 538,
"url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
"detected": null,
"metadata": { "doc_type": "business_registration" },
"status": "ACTIVE",
"processedAt": "2026-09-09T09:05:38.902Z",
"rag": "사업자등록증 등록번호 123-45-67890 법인명 주식회사 에이씨엠이 트레이딩 ...",
"createdAt": "2026-09-09T09:05:31.412Z"
}
]
}
응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
count | number | 아이템 수 |
items[].id | string | 아이템 ID (item_ 접두사) |
items[].folderId | string | 소속 폴더 ID |
items[].type | string | file · text · json |
items[].name | string | 아이템 이름 |
items[].content | string | object | null | 등록 시 보낸 본문. file 타입은 null |
items[].contentType | string | null | MIME 타입 |
items[].sizeBytes | number | null | 크기(바이트) |
items[].url | string | null | 추출 텍스트의 S3 URL. status가 ACTIVE일 때만 채워짐 |
items[].detected | object | null | 자동 감지 정보(contentType, extension, fileCategory). 파일 타입만 |
items[].metadata | object | null | 사용자 정의 메타데이터 |
items[].status | string | PENDING · ACTIVE · FAILED |
items[].processedAt | string | null | 처리 완료 시각. PENDING이면 null |
items[].rag | string | null | 분석에 실제로 쓰이는 추출·정제 본문. ACTIVE일 때만 채워짐 |
items[].createdAt | string | 생성 시각 |
아이템 단건 조회
GET /v1/items/{itemId}
folder 객체가 추가됩니다.
curl "https://client-omni-api.argosidentity.com/v1/items/item_ieoravdq3jp3" \
-H "x-api-key: your-api-key-here"
응답
{
"id": "item_ieoravdq3jp3",
"folderId": "fd_dvh8axwowi4v",
"type": "text",
"name": "사업자등록증",
"content": "사 업 자 등 록 증\n(법인사업자)\n\n등록번호: 123-45-67890 ...",
"contentType": "text/plain",
"sizeBytes": 538,
"url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
"detected": null,
"metadata": { "doc_type": "business_registration" },
"status": "ACTIVE",
"processedAt": "2026-09-09T09:05:38.902Z",
"rag": "사업자등록증 등록번호 123-45-67890 법인명 주식회사 에이씨엠이 트레이딩 ...",
"folder": {
"id": "fd_dvh8axwowi4v",
"name": "default"
},
"createdAt": "2026-09-09T09:05:31.412Z"
}
| 필드 | 타입 | 설명 |
|---|---|---|
folder.id | string | 소속 폴더 ID |
folder.name | string | 소속 폴더 이름 |
에러 코드
| 상태 | 코드 | 설명 |
|---|---|---|
| 404 | OMNI_3009 | 폴더를 찾을 수 없음(목록 조회) |
| 404 | OMNI_3006 | 아이템을 찾을 수 없음(단건 조회) |