결과 구조 이해

추출 완료 후 반환되는 JSON 응답의 각 필드를 설명합니다.

---

응답 예시

{
  "documentId": 664,
  "taskId": "1fb48150-4805-4576-a825-61dde155caab",
  "totalPages": 1,
  "metadata": {
    "createdDateTime": "2026-02-12T06:27:38.168991+00:00",
    "apiVersion": "v1.14.0"
  },
  "pages": [
    {
      "pageIdx": 1,
      "details": {
        "docTitle": {
          "text": "재직증명서",
          "bbox": [0.364, 0.092, 0.652, 0.123]
        },
        "personalInfo": {
          "name": {
            "text": "남동기",
            "bbox": [0.335, 0.233, 0.428, 0.246]
          },
          "address": {
            "text": "전라남도 나주시 금천면 유전길 141-11",
            "bbox": [0.268, 0.272, 0.629, 0.287]
          }
        },
        "employmentInfo": {
          "department": {
            "text": "공사부",
            "bbox": [0.331, 0.366, 0.433, 0.380]
          },
          "period": {
            "text": "2022년 02월 01일 ~ 현재",
            "bbox": [0.451, 0.406, 0.715, 0.420]
          }
        }
      }
    }
  ]
}

---

최상위 필드

필드	타입	설명
documentId	number	문서 고유 ID
taskId	string	추출 작업 고유 ID
totalPages	number	문서 총 페이지 수
metadata	object	작업 메타데이터
pages	array	페이지별 추출 결과 배열

metadata

필드	타입	설명
createdDateTime	string	작업 생성 시각 (ISO 8601)
apiVersion	string	사용된 API 버전

---

pages 배열

필드	타입	설명
pageIdx	number	페이지 번호 (1부터 시작)
details	object	추출된 항목의 Key-Value 결과

details 구조

details 하위에는 스키마에서 정의한 키가 위치합니다. 각 키의 값은 아래 필드를 포함합니다.

필드	타입	설명
text	string	추출된 텍스트 값
bbox	array	문서 내 위치 좌표 ([x1, y1, x2, y2], 0~1 정규화 값)

중첩된 객체 구조는 스키마 정의에 따라 달라집니다. 예시의 personalInfo, employmentInfo는 스키마에서 그룹으로 정의한 경우입니다.

---