메인 콘텐츠로 건너뛰기

​
폴더의 아이템 목록 조회

GET /v1/folders/{folderId}/items

​
요청

curl -X GET "http://client-omni-api.argosidentity.com/v1/folders/{folderId}/items?type=file&sort=createdAt&order=desc" \
  -H "x-api-key: your-api-key-here"

​
쿼리 파라미터

파라미터타입기본값설명
typestring아이템 타입으로 필터: file, text, json
searchstring아이템 이름으로 검색
sortstringcreatedAt정렬 필드: name, type, createdAt
orderstringdesc정렬 순서: asc, desc

​
응답

{
  "count": 2,
  "items": [
    {
      "id": "item_abc123",
      "folderId": "fld_default001",
      "type": "file",
      "name": "business_registration.pdf",
      "content": null,
      "contentType": "application/pdf",
      "sizeBytes": 245678,
      "url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
      "detected": {
        "contentType": "application/pdf",
        "extension": "pdf",
        "fileCategory": "document"
      },
      "metadata": {
        "documentType": "business_registration"
      },
      "status": "ACTIVE",
      "processedAt": "2026-03-15T10:10:05Z",
      "createdAt": "2026-03-15T10:10:00Z",
      "rag": "사업자등록증\n상호: 주식회사 아크미..."
    }
  ]
}
​
items[].contentType
string | null
MIME 타입 (파일 아이템만 해당)
​
items[].sizeBytes
number | null
파일 크기 (바이트, 파일 아이템만 해당)
​
items[].url
string | null
추출된 텍스트 URL (검색/RAG용)
​
items[].detected
object | null
자동 감지된 파일 정보: contentType, extension, fileCategory
​
items[].rag
string | null
OCR로 추출 및 정제된 텍스트 (처리 중에는 null)

​
아이템 ID로 조회

GET /v1/items/{itemId}

curl -X GET "http://client-omni-api.argosidentity.com/v1/items/{itemId}" \
  -H "x-api-key: your-api-key-here"

{
  "id": "item_abc123",
  "folderId": "fld_default001",
  "type": "file",
  "name": "business_registration.pdf",
  "content": null,
  "contentType": "application/pdf",
  "sizeBytes": 245678,
  "url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
  "detected": {
    "contentType": "application/pdf",
    "extension": "pdf",
    "fileCategory": "document"
  },
  "metadata": {
    "documentType": "business_registration"
  },
  "status": "ACTIVE",
  "processedAt": "2026-03-15T10:10:05Z",
  "folder": {
    "id": "fld_default001",
    "name": "default"
  },
  "createdAt": "2026-03-15T10:10:00Z",
  "rag": "사업자등록증\n상호: 주식회사 아크미..."
}
folder 객체는 아이템 상세 응답에만 포함되며, 목록 응답에는 포함되지 않습니다.

​
에러 코드

상태코드설명
404ITEM_NOT_FOUND아이템을 찾을 수 없음