메인 콘텐츠로 건너뛰기
단일 API 호출로 문서를 처리하는 전형적인 시나리오(트랜잭션 생성, 파일 업로드, 트랜잭션 시작)는 다음 단계로 구성됩니다:
  1. 사용 가능한 모든 Skill 목록을 받습니다.
  2. 트랜잭션을 생성하고 시작합니다.
  3. 트랜잭션 상태를 모니터링합니다.
  4. 원본 파일과 결과 파일을 다운로드합니다.
서버로 보내는 각 요청에는 인증 정보가 포함되어야 합니다. 자세한 내용은 Authentication을 참조하세요. 이 시나리오는 크기가 30 MB 미만인 파일이 하나 있고, 해당 파일의 이미지를 편집할 필요가 없을 때 사용하세요.

​
1단계. 사용 가능한 모든 스킬 목록 가져오기

사용 가능한 모든 스킬 목록을 가져오려면 skills 리소스에 GET 요청을 보냅니다: 다음 명령을 실행합니다: 응답으로 애플리케이션 인스턴스에 추가된 모든 스킬에 대한 정보가 반환됩니다.

​
2단계. 트랜잭션 생성 및 시작

트랜잭션을 생성하고 시작하려면 transactions/launch 리소스에 POST 요청을 보냅니다: URL에서 skillId 쿼리 매개변수(이전 API 호출에서 반환된 값)를 지정합니다. 요청 본문에는 처리할 파일과 선택적 메타데이터를 함께 포함해 전송합니다. 또한 요청 본문에 선택적으로 registrationParameters 및 skillParameters를 전달할 수 있습니다. 다음은 요청 본문 예시입니다: 
{
  "files": [
    {
    }
  ]
}
다음 명령을 실행하세요: 이 명령을 실행하면 생성된 트랜잭션의 id가 포함된 응답을 받습니다.

​
3단계. 트랜잭션 상태 모니터링

트랜잭션 상태를 모니터링하려면 transactions 리소스에 GET 요청을 전송합니다: 다음 명령을 실행합니다: 요청에 대한 응답으로 트랜잭션 상태를 포함한 응답이 반환됩니다. 트랜잭션 처리 상태는 다음 중 하나일 수 있습니다:
  • New. 트랜잭션이 생성되었지만 아직 처리 대기열에 들어가지 않았습니다.
  • Queued. 트랜잭션이 처리 대기열에 있습니다.
  • InProgress. 트랜잭션이 처리 중입니다.
  • Processed. 트랜잭션이 성공적으로 처리되었습니다.
  • ProcessedWithWarnings. 트랜잭션이 처리되었지만 경고가 발생했습니다.
  • NotProcessed. 오류로 인해 트랜잭션이 처리되지 않았습니다.
  • Deleted. 트랜잭션이 사용자가 삭제했거나 보존 정책에 따라 자동으로 삭제되었습니다.
트랜잭션 상태가 Processed 또는 ProcessedWithWarnings인 경우 4단계로 진행합니다.

​
4단계. 소스 파일 및 결과 파일 다운로드

소스 파일과 결과 파일을 다운로드하려면 이전 요청에서 받은 파일 ID를 지정하여 transactions/files/download 리소스에 GET 요청을 보냅니다: 다음 명령을 실행합니다: