변경 로그
우리의 버전 정책: 새 필드와 새 엔드포인트는 추가적이며 /api/v1/ 접두사 아래에서 주요 변경 사항으로 간주되지 않습니다. 기존 필드의 의미를 제거하거나 변경하는 것은 v2가 될 일입니다. 즉, 아래의 모든 항목을 '새로 추가된 것'으로 보면 되지, '통합을 깨뜨릴 수 있는 것'으로 볼 필요는 없습니다.
2026-09-26
format_requirement가 임시fields에 이제 적용됩니다.POST /batches/{batch_name}/process가fields로 호출되었을 때(template_id없이), 각 필드의format_requirement는 추출 전에 삭제되어 값이 문서에 인쇄된 그대로 반환되었습니다. 이제 이 값은 모델에 도달하며, 문서 업로드 시 사용된 어떤 템플릿보다 우선합니다. 저장된 템플릿에는 영향을 주지 않습니다. Batches 참조를 확인하세요.POST /documents는 50자를 초과하는batch_name을400 invalid_parameter로 거부합니다. 이러한 이름은 이전에 500 오류로 실패하거나, PDF 업로드 시 'Failed to render PDF.'라는 오해를 부르는 오류가 발생했습니다.
2026-09-14
PUT /templates/{id}/settings추가됨. 템플릿의 전역 형식 요구 사항과 다중 페이지 병합 구성을 설정합니다(동일 레코드에 속하는 여러 업로드 페이지(다중 페이지 임대 계약서, 스테이플로 묶인 영수증 묶음)를 단일 출력 행으로 접을지 여부). 모든 템플릿 엔드포인트가 반환하는Template객체에는 이제global_format_requirement및 모든merge_*필드도 포함됩니다. Templates & Fields 참조를 확인하세요.GET /batches/{batch_name}/results가 이제?merge=true를 지원함. 배치의 확인된 템플릿의 다중 페이지 병합 구성을 적용합니다(있는 경우). 병합된 레코드로 접히는 문서는 기존document_id와 함께 새source_document_ids필드를 가지며, 응답에는 최상위merge_active필드가 추가됩니다. 기본값은false로 유지됩니다. 이 엔드포인트는 다중 페이지 병합 이전에 존재했으므로 기존 통합은 명시적으로 선택하지 않는 한 업로드된 문서당 하나의 항목을 계속 확인합니다.include=bbox와 함께 사용할 수 없습니다.GET /batches/{batch_name}/export는 이 변경 전에 이미 병합을 무조건 적용했으며 영향을 받지 않습니다. Batches 참조를 확인하세요.POST /batches/{batch_name}/process의 크레딧 계산에서 모델 티어가 이제 올바르게 반영됨. Advanced 또는 Premium(문서당 Standard 크레딧 비용의 3배/6배)이 할당된 계정은 이제 처리 시 차감과 취소 또는 실패한 문서에 대한 추후 환불 모두에 해당 요율이 일관되게 적용됩니다. 이전에는 환불이 실행될 때ImageUpload행이 이미 제거된 문서가 Standard 요율로 환불되어 비Standard 계정이 덜 환불받을 수 있었습니다. 비Standard 차감/환불에 대한GET /account/usage항목은 이제 기본 이름 대신 티어 접미사가 붙은action(deduction_advanced,deduction_premium)을 포함합니다. 모델 티어 자체는 새로운 것이 아니며, 이를 선택하거나 재정의할 수 있는 요청 수준 방법도 여전히 없습니다. 이 항목은 새로운 기능이 아니라 계산이 이제 정확하고 표시된다는 내용입니다. Account Settings & API Behavior 안내 및 Account 참조를 확인하세요.
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파일은 페이지당 하나의 Document를 생성하며, 현재 PDF 동작과 동일합니다. 레거시 바이너리.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/의 공개 릴리스로,table(구조화된 필드 추출) 처리 모드의 Documents, Batches, Templates & Fields, Webhooks, Account 리소스를 다룹니다. 시작하려면 API 개요를 참조하세요.