변경 로그
버전 정책 안내: 새 필드와 새 엔드포인트는 추가적이며 /api/v1/ 접두어 하에서 주요 변경 사항으로 간주되지 않습니다. 기존 필드를 제거하거나 의미를 바꾸는 것은 v2에 해당합니다. 따라서 아래의 모든 항목은 "새로 추가된 내용"이지 "통합이 깨질 수 있는 변경"이 아닙니다.
2026-08-04
- 폴링 방식 통합을 위한
GET /events추가. 이벤트 피드는batch.completed,document.completed,document.failed이벤트를 최신순으로 반환하며, Zapier 스타일 중복 제거를 위한 안정적인 이벤트 ID를 제공합니다. Webhooks 참조를 확인하세요.
2026-07-22
POST /templates가 이제 계정당 템플릿 30개 상한을 적용합니다. 상한에 도달하면 새 템플릿 생성 시400 template_limit_reached오류가 반환됩니다. 기존 템플릿을 먼저 삭제하세요. 이 제한은 이전에는 적용되지 않았습니다. Templates & Fields 참조를 확인하세요.
2026-07-21
POST /documents가 이제 이미지와 PDF뿐만 아니라 Word(.docx) 및 일반 텍스트(.txt) 파일도 지원합니다. 두 형식 모두 서버 측에서 PDF로 변환된 후 네이티브 PDF 업로드와 동일한 페이지별 분할 방식을 따릅니다. 여러 페이지로 구성된.docx파일은 현재 PDF와 동일하게 페이지당 하나의 Document를 생성합니다. 레거시 바이너리.doc형식은 지원되지 않으므로 먼저.docx로 저장하세요. Documents 참조를 확인하세요.- 업로드당 페이지 제한이 30페이지에서 50페이지로 상향 조정되었습니다. 네이티브 PDF 업로드와 서버 측에서 변환되는
.docx/.txt파일 모두에 적용됩니다. Documents 참조를 확인하세요. GET /documents/{document_id}/image가 이제?size=thumb을 지원합니다. 페이지 이미지의 더 작고 미리 생성된 버전을 제공하여 목록/그리드 보기에서 전체 해상도 페이지보다 빠르게 로드할 수 있습니다. 해당 문서에 대해 썸네일이 생성되지 않은 경우 전체 이미지로 대체됩니다. Documents 참조를 확인하세요.
2026-07-20
- 배치 웹훅은 배치를 다시 처리할 때 자동으로 재설정됩니다. 이미 한 번 알림을 받은 배치에 문서를 더 업로드하고
process를 다시 호출하면, 새 작업이 완료될 때 다시 알림을 받게 됩니다 — 웹훅을 다시PUT할 필요가 없습니다. Webhooks 가이드를 참조하세요. 현재 각 작업 전에 웹훅을 다시 등록하는 방식으로 우회하고 있다면, 그 호출은 실제로 아무것도 재설정하지 않았으므로 중단해도 안전합니다. - Bbox 주석 작업이 이제 웹훅 이벤트를 전달합니다. bbox 작업이 최종 상태에 도달하면 문서의 배치 웹훅에서
document.bbox_completed이벤트가 발생합니다 — 이전에는 등록 여부와 관계없이 bbox 완료에 대한 알림이 전혀 생성되지 않았습니다. Webhooks 가이드를 참조하세요. POST /documents응답에remaining_batch_capacity가 추가되었습니다.GET /account를 별도로 호출하지 않고도 이 배치가 플랜의 최대 배치 크기에 도달하기 전에 추가로 수용할 수 있는 문서 수를 알려줍니다.document.bbox_completed전달이 이제batch.completed와 동일하게 원자적으로 처리됩니다. 서로 다른 스레드에서 행 그룹이 거의 동시에 완료되는 bbox 작업은 논리적으로 하나의 완료임에도 두 번의 개별 전달이 발생하곤 했습니다 — 더 이상 그런 일은 없어야 합니다.data.group_batch_id로 이러한 이벤트를 중복 제거하는 방식으로 우회하고 있다면, 계속해도 무방합니다.
2026-07-16
- v1 API 출시.
/api/v1/의 공개 릴리스로, Documents, Batches, Templates & Fields, Webhooks, Account 리소스를table처리 모드로 지원합니다. 시작하려면 API 개요를 참조하세요.