메인 콘텐츠로 건너뛰기
The ABBYY Vantage 플랫폼은 지능형 문서 처리를 애플리케이션에 통합할 수 있도록 두 가지 REST API를 제공합니다.

Processing API

문서를 전송하고 트랜잭션을 관리하며 추출된 데이터를 가져옵니다

Reporting API

분석 및 비즈니스 보고용 데이터에 접근합니다

​
기본 URL

모든 API 요청은 Vantage 운영 서버로 전송됩니다.

​
인증

Vantage API는 인증을 위해 OAuth 2.0을 사용합니다. 모든 요청의 Authorization 헤더에는 액세스 토큰이 포함되어야 합니다: 
Authorization: Bearer {your_access_token}
Vantage는 세 가지 인증 플로우를 지원합니다:
FlowBest For
Resource Owner Password Credentials서버 간 통합
Authorization Code Flow사용자 대상 앱
Client Credentials머신 간 통신
ABBYY Vantage에서 테넌트를 발급받으려면 Contact ABBYY 페이지를 통해 문의하세요. 테넌트 계정을 발급받으면 인증에 사용할 사용자 계정과 API 클라이언트를 생성할 수 있습니다.

​
Processing API

Processing API(/api/publicapi/v1/)를 사용하면 다음을 수행할 수 있습니다:
  • 트랜잭션 생성 — 특정 스킬을 사용해 문서를 제출하여 처리
  • 파일 관리 — 문서 이미지를 업로드, 편집 및 정리
  • 상태 추적 — 트랜잭션 진행 상황 모니터링 및 오류 처리
  • 결과 가져오기 — 추출된 데이터를 JSON 또는 XML 형식으로 다운로드
  • 카탈로그 관리 — 데이터 카탈로그 및 조회 테이블 작업

​
일반적인 워크플로

업로드, 처리, 결과 조회를 자동으로 수행하는 단일 요청으로 문서를 처리합니다.자세히 알아보기 →
문서 업로드, 처리, 결과 조회를 보다 세밀하게 제어하기 위해 별도의 API 호출을 사용합니다.자세히 알아보기 →
사람 검증이 필요한 문서를 처리할 수 있도록 워크플로에 수동 검토 단계를 통합합니다.자세히 알아보기 →

​
Reporting API

Reporting API(/api/reporting/v2/)는 다음에 액세스할 수 있도록 제공합니다:
  • 비즈니스 지표 — 트랜잭션 수량, 처리 시간, 처리량(throughput)
  • 품질 분석 — 추출 정확도 및 신뢰도 점수
  • field 수준 데이터 — 분석을 위한 상세 추출 결과
Reporting에 대해 더 알아보기 →

​
출력 형식

Vantage는 추출된 데이터를 구조화된 형식으로 반환합니다:

JSON Output

전체 추출 세부 정보와 신뢰도 점수가 포함된 계층적 데이터

XML Output

XML 연동이 필요한 시스템을 위한 구조화된 마크업

​
개발자 자료

개발자 가이드

Vantage API 통합을 위한 종합 가이드

Postman 컬렉션

테스트 및 실험을 위한 즉시 사용 가능한 API 컬렉션

​
요율 제한 및 모범 사례

  • 배치 작업 — 여러 레코드를 처리할 때는 배치 엔드포인트를 사용하세요(요청당 최대 5,000개의 카탈로그 레코드)
  • 폴링 — 트랜잭션 상태를 확인할 때는 적절한 간격(5~10초)을 두고 요청하세요
  • 오류 처리 — 일시적인 오류에 대해서는 지수 백오프를 사용하는 재시도 로직을 구현하세요

​
다음 단계

1

인증 설정

애플리케이션에 대해 OAuth 2.0을 구성하세요
2

첫 문서 처리하기

문서를 제출하려면 처리 가이드를 따르세요
3

API 둘러보기

전체 Processing API 및 Reporting API 참조 문서를 살펴보세요