# API 변경 로그 — 추가적, 절대 주요 변경 사항 없음

> ImageToTable.ai v1 API의 릴리스 기록입니다. 모든 새 필드나 엔드포인트는 추가적이며 주요 변경 사항이 아니므로, 이 로그는 기존 통합을 업데이트할 필요 없이 새로운 내용을 추적합니다.

저희의 버전 관리 정책: 새 필드와 새 엔드포인트는 추가적이며 `/api/v1/` 접두사 아래에서 주요 변경 사항으로 간주되지 않습니다. 기존 필드를 제거하거나 의미를 변경하는 것은 v2가 됩니다. 즉, 아래의 모든 항목을 "여기에 통합이 중단될 수 있는 내용"이 아닌 "새로운 내용"으로 보셔도 됩니다.

## 2026-07-20

- **배치를 재처리하면 배치 웹훅이 자동으로 다시 활성화됩니다.** 이미 한 번 알림을 보낸 배치에 문서를 더 업로드하고 `process`를 다시 호출하면, 새 작업이 완료될 때 다시 알림을 받게 됩니다. 웹훅을 다시 `PUT`할 필요가 없습니다. 자세한 내용은 [Webhooks 가이드](/developers/guides/webhooks#reprocessing-a-batch)를 참조하세요. 현재 통합에서 각 작업 전에 웹훅을 다시 등록하는 방식으로 우회하고 있다면, 중단해도 안전합니다. 그 호출은 실제로 아무것도 다시 활성화하지 않았습니다.
- **Bbox 주석 작업이 이제 웹훅 이벤트를 전달합니다.** bbox 작업이 최종 상태에 도달하면 문서의 배치 웹훅에서 `document.bbox_completed` 이벤트가 발생합니다. 이전에는 bbox 완료 시 등록 여부와 관계없이 알림이 전혀 생성되지 않았습니다. 자세한 내용은 [Webhooks 가이드](/developers/guides/webhooks#event-envelope)를 참조하세요.
- **`POST /documents` 응답에 `remaining_batch_capacity`가 추가되었습니다.** `GET /account`를 별도로 호출하지 않고도 이 배치가 요금제의 최대 배치 크기에 도달하기 전에 얼마나 더 많은 문서를 수용할 수 있는지 알려줍니다.
- **`document.bbox_completed` 전달이 이제 `batch.completed`와 동일하게 원자적으로 처리됩니다.** 서로 다른 스레드에서 행 그룹이 거의 동시에 완료되는 bbox 작업이 논리적으로 하나의 완료임에도 불구하고 두 개의 개별 전달을 발생시키는 경우가 있었습니다. 더 이상 이런 현상이 발생하지 않아야 합니다. 통합에서 이러한 이벤트를 `data.group_batch_id`로 중복 제거하는 방식으로 우회하고 있다면, 계속해도 문제없습니다.

## 2026-07-16

- **v1 API가 출시되었습니다.** `table` 처리 모드에 대한 Documents, Batches, Templates & Fields, Webhooks, Account 리소스를 포함하는 `/api/v1/`의 공개 릴리스입니다. 시작하려면 [API 개요](/developers/)를 참조하세요.

---

Source: https://imagetotable.ai/ko/developers/changelog