메인 콘텐츠로 건너뛰기
활성 또는 완료된 트랜잭션 목록은 다음과 같이 사용할 수 있습니다:
  • 현재 수동 검토 단계에 있는 활성 트랜잭션을 추적합니다.
  • 활성 트랜잭션에 대한 수동 검토 링크를 가져옵니다.
  • 완료된 트랜잭션의 결과 파일을 다운로드합니다.
Vantage API를 사용하여 식별자와 함께 트랜잭션 목록을 가져올 수 있습니다. Skill Monitor를 사용하면 더 고급 필터를 적용할 수 있습니다.

​
활성 트랜잭션 목록

활성 트랜잭션 목록을 가져오려면 transactions/active 리소스에 GET 요청을 전송합니다. 요청 본문에 다음 매개변수를 지정합니다.
ParameterDescription
StageType트랜잭션의 단계입니다.
가능한 값은 다음과 같습니다.
- ManuaReview
- CustomActivity
- Automatic (사용자가 개입할 필요가 없는 모든 단계, 예: field 추출)
StageName특정 작업의 이름입니다(ManualReview 단계에서만 사용).
SkillId스킬 식별자입니다.
값을 지정하지 않으면 사용 가능한 모든 스킬이 대상이 됩니다.
SkillVersion스킬 버전입니다.
값을 지정하지 않으면 사용 가능한 스킬의 모든 버전이 대상이 됩니다.
StartDate가장 이른 트랜잭션의 생성 시각입니다(UTC 형식으로 지정해야 합니다).
EndDate가장 늦은 트랜잭션의 생성 시각입니다(UTC 형식으로 지정해야 합니다).
이 값을 지정하지 않으면 현재 UTC 시간이 대신 사용됩니다.
TransactionParameterskey-value string 쌍으로 구성된 트랜잭션 매개변수 목록입니다. 이 매개변수는 추가 사용자 정보를 제공합니다(예: 고객 이름).
매개변수는 다음 형식으로 제공해야 합니다: TransactionParameters={“key”: “string_1”,”value”:”string”}&TransactionParameters={“key”: “string_2”,”value”:”string”}
DocumentParameterskey-value string 쌍으로 구성된 문서 매개변수 목록입니다. 이 매개변수는 추가 문서 정보를 제공합니다(예: 파일 이름).
매개변수는 다음 형식으로 제공해야 합니다: DocumentParameters={“key”: “string_1”,”value”:”string”}&DocumentParameters={“key”: “string_2”,”value”:”string”}
Offset페이지네이션 오프셋입니다.
이 매개변수의 기본값은 0입니다.
Limit페이지네이션 제한값입니다. 필수 매개변수입니다.
이 매개변수의 기본값은 0입니다.
요청 예: 지정된 스킬 식별자가 있는 요청에 대한 응답에는 다음과 유사한 JSON 파일이 포함됩니다. 
{
  "items": [
    {
      "stage": "ManualReview",
      "stageName": "Review",
      "seqId": 13758,
      "transactionId": "56a50415-fe1d-4493-81ba-97ff07e3ffce",
      "createTimeUtc": "2023-09-11T13:53:30.633Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "App",
          "value": "PublicAPI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "Index",
          "value": "0"
        },
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "BillofLading_1.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "PublicAPI"
        }
      ],
      "skillId": "workspace.default.processing",
      "skillVersion": 18,
      "documentCount": 1
    }
  ],
  "totalItemCount": 7
}
지정된 단계와 작업이 포함된 요청에 대한 응답에는 아래와 유사한 모든 활성 트랜잭션을 담은 JSON 파일이 포함됩니다. 
{
  "items": [
    {
      "stage": "ManualReview",
      "stageName": "Review2",
      "seqId": 13852,
      "transactionId": "e646754e-d854-4b21-af91-58cb63ead7a6",
      "createTimeUtc": "2023-09-11T14:04:37.97Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "App",
          "value": "PublicAPI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "Index",
          "value": "0"
        },
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "BillofLading_1.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "PublicAPI"
        }
      ],
      "documentCount": 1
    }
  ],
  "totalItemCount": 2
}
현재 진행 중인 트랜잭션에 대해서도 수동 검토 클라이언트 링크를 얻을 수 있습니다. 이를 위해 요청 URI에 트랜잭션 식별자를 포함하여 transactions/<transaction_id> 리소스에 GET 요청을 전송합니다. 요청 예: 응답에는 다음과 유사한 코드가 포함됩니다. manualReviewLink 키에는 수동 검토 클라이언트의 웹 인터페이스 링크와, 수동 검토가 필요한 경우 Vantage 액세스 토큰이 포함됩니다. 이 링크와 토큰을 사용하여 특정 트랜잭션의 분류 및 field 추출 결과를 검토하고 수정할 수 있습니다. 제공된 링크는 168시간 동안만 유효하며, 이후에는 동일한 방법을 사용해 새로운 링크를 생성하고 다시 168시간 동안 사용할 수 있습니다. 자세한 내용은 Integrating manual review를 참조하세요.
이 링크로 인증된 사용자는 다른 문서나 트랜잭션을 보거나 수정할 수 없습니다.

​
완료된 트랜잭션 목록

완료된 트랜잭션 목록을 가져오려면 transactions/completed 리소스에 GET 요청을 전송합니다. 요청 본문에 다음과 같은 매개변수를 지정합니다:
ParameterDescription
TransactionStatus트랜잭션의 상태입니다.
가능한 값은 다음과 같습니다:
- Processed
- Canceled
- Failed
SkillId스킬 식별자입니다.
값을 지정하지 않으면 사용 가능한 모든 Skill이 고려됩니다.
SkillVersion스킬 버전입니다.
값을 지정하지 않으면 사용 가능한 Skill의 모든 버전이 고려됩니다.
StartDate가장 이른 트랜잭션의 생성 시간입니다(UTC 형식으로 지정해야 합니다).
EndDate가장 최근 트랜잭션의 생성 시간입니다(UTC 형식으로 지정해야 합니다).
이 값을 지정하지 않으면 현재 UTC 시간이 대신 사용됩니다.
TransactionParameters키-값 string 쌍으로 구성된 트랜잭션 매개변수 목록입니다. 이러한 매개변수는 추가적인 사용자 정보를 제공합니다(예: 클라이언트 이름).
매개변수는 다음 형식으로 제공해야 합니다: TransactionParameters={“key”: “string_1”,”value”:”string”}&TransactionParameters={“key”: “string_2”,”value”:”string”}
DocumentParameters키-값 string 쌍으로 구성된 문서 매개변수 목록입니다. 이러한 매개변수는 추가적인 문서 정보를 제공합니다(예: 파일 이름).
매개변수는 다음 형식으로 제공해야 합니다: DocumentParameters={“key”: “string_1”,”value”:”string”}&DocumentParameters={“key”: “string_2”,”value”:”string”}
Offset페이징 오프셋입니다.
이 매개변수의 기본값은 0입니다.
Limit페이징 제한 값입니다. 필수 매개변수입니다.
이 매개변수의 기본값은 0입니다.
응답에는 모든 완료된 트랜잭션과 처리된 페이지 수가 포함된 JSON 파일이 다음 예시와 유사한 형태로 반환됩니다: 
{
  "items": [
    {
      "status": "완료됨",
      "pageCount": 1,
      "seqId": 13705,
      "transactionId": "fc9920fe-f788-47f8-9972-b767493faed9",
      "createTimeUtc": "2023-09-11T13:47:50.273Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "App",
          "value": "PublicAPI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "Index",
          "value": "0"
        },
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "BillofLading_1.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "PublicAPI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "완료됨",
      "pageCount": 2,
      "seqId": 29842,
      "transactionId": "c0dd3e08-f295-4c6c-b919-31eaa67817cc",
      "createTimeUtc": "2023-09-12T19:28:01.27Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed _1_.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "완료됨",
      "pageCount": 2,
      "seqId": 36254,
      "transactionId": "8391871e-abf5-41bc-8a66-1059418a3843",
      "createTimeUtc": "2023-09-13T08:53:41.9Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed _1_.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "완료됨",
      "pageCount": 2,
      "seqId": 36632,
      "transactionId": "7f7cd557-a03e-42e3-a454-e7981e8e9fc0",
      "createTimeUtc": "2023-09-13T09:35:27.48Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "완료됨",
      "pageCount": 2,
      "seqId": 36663,
      "transactionId": "c9b3cd4d-d90f-48be-adc2-99985ece4e11",
      "createTimeUtc": "2023-09-13T09:38:29.573Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    }
  ],
  "totalItemCount": 5
}