답변 출처 Excel 문서 미리보기 조회

일반 문서 출처의 Excel(.xls/.xlsx) 또는 CSV 파싱 결과를 시트와 표·텍스트 블록으로 반환한다. SQL retrieval 결과 조회 API가 아니며 retrievalId를 받거나 반환하지 않는다. X-Storm-Token이 속한 채널과 에이전트가 소유한 chatId 안에서 docRef가 문서 출처로 포함되어 있어야 한다. 삭제된 문서, Excel/CSV 이외 문서, 신뢰할 수 있는 파싱 원문이 없는 문서는 404다. 저장소 signed URL과 Cybros 인증정보는 응답에 포함하지 않는다. 현재 시트 이름과 선택 단서는 null이다. 원문 다운로드 상한은 5 MiB, 요청 제한 시간은 10초이며 페이지 수는 1~500개다. 기존 GET /api/v2/answer/{chatId}/documents/{docRef}의 document.previewType이 spreadsheet이면 이 API를 사용한다. 해당 필드가 없으면 기존 PDF 뷰어를 유지한다.

Responses

🟢200OK

application/json

문서명과 시트별 표·텍스트 블록. 별도 data 래퍼 없이 반환한다.

Bodyapplication/json

Example

{
    "document": {
        "filename": "매출.xlsx"
    },
    "sheets": [
        {
            "id": "section-1",
            "name": null,
            "pageNumber": 1,
            "blocks": [
                {
                    "type": "table",
                    "columns": [
                        "상품",
                        "매출"
                    ],
                    "rows": [
                        [
                            "상품 A",
                            "1000"
                        ]
                    ]
                },
                {
                    "type": "text",
                    "text": "단위: 원"
                }
            ]
        }
    ],
    "selectedSheetId": null
}

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠413

🟠422Parameter Error

🔴502Bad Gateway

답변 출처 Excel 문서 미리보기 조회

Request

Responses