メインコンテンツへスキップ
アクティブまたは完了したすべてのトランザクションの一覧は、次の目的で使用できます。
  • 現在手動確認ステージにあるアクティブなトランザクションを追跡する。
  • アクティブなトランザクションの手動確認用リンクを取得する。
  • 完了したトランザクションの結果ファイルをダウンロードする。
Vantage API を使用して、トランザクションの ID とともに一覧を取得できます。より高度なフィルターを適用するには、Skill Monitor を使用できます。

​
アクティブなトランザクションの一覧

アクティブなトランザクションの一覧を取得するには、transactions/active リソースに GET リクエストを送信します。 リクエスト本文では、次のパラメーターを指定します。
ParameterDescription
StageTypeトランザクションのステージ。
指定可能な値は次のとおりです。
- ManuaReview
- CustomActivity
- Automatic（ユーザー操作が不要なすべてのステージ。例: field の抽出）
StageName特定のアクションの名前（ManualReview ステージでのみ使用）。
SkillIdSkill の識別子。
値を指定しない場合は、利用可能なすべての Skill が対象になります。
SkillVersionSkill のバージョン。
値を指定しない場合は、利用可能な 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 です。
リクエスト例（Windows）: 
curl -X GET "https://vantage-eu.abbyy.com/api/publicapi/v1/transactions/active"
-H "Authorization: Bearer token"
他のリージョン向けも利用可能です: 
# 北米
curl -X GET "https://vantage-us.abbyy.com/api/publicapi/v1/transactions/active" \
  -H "Authorization: Bearer token"

# オーストラリア
curl -X GET "https://vantage-au.abbyy.com/api/publicapi/v1/transactions/active" \
  -H "Authorization: Bearer token"
サンプルリクエスト（Linux）： 
curl -X GET 'https://vantage-eu.abbyy.com/api/publicapi/v1/transactions/active' \
  -H 'Authorization: Bearer token'
他のリージョン向けも提供されています： 
# 北米
curl -X GET 'https://vantage-us.abbyy.com/api/publicapi/v1/transactions/active' \
  -H 'Authorization: Bearer token'

# オーストラリア
curl -X GET 'https://vantage-au.abbyy.com/api/publicapi/v1/transactions/active' \
  -H 'Authorization: Bearer token'
Skill識別子が指定されたリクエストに対するレスポンスには、次のようなJSONファイルが含まれます。 
{
  "items": [
    {
      "stage": "ManualReview",
      "stageName": "レビュー",
      "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 リクエストを送信します。 サンプルリクエスト（Windows）: 
curl -X GET "https://vantage-eu.abbyy.com/api/publicapi/v1/transactions/transaction-id" \
  -H "Authorization: Bearer token"
他の地域でも利用可能です： 
# 北米
curl -X GET "https://vantage-us.abbyy.com/api/publicapi/v1/transactions/transaction-id" \
  -H "Authorization: Bearer token"

# オーストラリア
curl -X GET "https://vantage-au.abbyy.com/api/publicapi/v1/transactions/transaction-id" \
  -H "Authorization: Bearer token"
サンプルリクエスト（Linux）： 
curl -X GET 'https://vantage-eu.abbyy.com/api/publicapi/v1/transactions/transaction-id' \
  -H 'Authorization: Bearer token'
他の地域でもご利用いただけます： 
# 北米
curl -X GET 'https://vantage-us.abbyy.com/api/publicapi/v1/transactions/transaction-id' \
  -H 'Authorization: Bearer token'

# オーストラリア
curl -X GET 'https://vantage-au.abbyy.com/api/publicapi/v1/transactions/transaction-id' \
  -H 'Authorization: Bearer token'
レスポンスには、次のようなコードが含まれます。 
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "Processing",
  "manualReviewLink": "https://vantage-eu.abbyy.com/api/publicapi/v1/verify?documentIds=9838448d-72ae-4e9a-b071-2bb16f732e46",
  "sourceFiles": [
    {
      "id": "7b2eed6f-3fdd-43b9-a178-7211d0a8d5bb",
      "name": "Invoice07.JPG"
    }
  ]
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "Processing",
  "manualReviewLink": "https://vantage-us.abbyy.com/api/publicapi/v1/verify?documentIds=9838448d-72ae-4e9a-b071-2bb16f732e46",
  "sourceFiles": [
    {
      "id": "7b2eed6f-3fdd-43b9-a178-7211d0a8d5bb",
      "name": "Invoice07.JPG"
    }
  ]
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "処理中",
  "manualReviewLink": "https://vantage-au.abbyy.com/api/publicapi/v1/verify?documentIds=9838448d-72ae-4e9a-b071-2bb16f732e46",
  "sourceFiles": [
    {
      "id": "7b2eed6f-3fdd-43b9-a178-7211d0a8d5bb",
      "name": "Invoice07.JPG"
    }
  ]
}
manualReviewLink キーには、手動確認が必要な場合、Manual Review クライアントのWebインターフェースへのリンクと Vantage のアクセス トークンが含まれます。このリンクとトークンを使用して、特定のトランザクションの分類および field 抽出結果を確認・修正できます。提供されるリンクの有効期限は168時間で、期限後は同じ方法で新しいリンクを作成して取得し、さらに168時間使用してください。詳細は、手動確認の統合を参照してください。
このリンクで認可されたユーザーは、他の documents やトランザクションを閲覧または変更することはできません。

​
完了したトランザクションの一覧

完了したトランザクションの一覧を取得するには、transactions/completed リソースに対して GET リクエストを送信します。 リクエストボディでは、次のパラメーターを指定します。
ParameterDescription
TransactionStatusトランザクションのステータス。
指定可能な値は次のとおりです。
- Processed
- Canceled
- Failed
SkillIdSkill の識別子。
値が指定されていない場合、利用可能なすべての Skill が対象となります。
SkillVersionSkill のバージョン。
値が指定されていない場合、利用可能なすべての Skill のバージョンが対象となります。
StartDate最も早いトランザクションの作成時刻（UTC 形式で指定する必要があります）。
EndDate最も遅いトランザクションの作成時刻（UTC 形式で指定する必要があります）。
この値が指定されていない場合は、現在の UTC 時刻が使用されます。
TransactionParametersキーと値の文字列ペアで構成されるトランザクションパラメーターの一覧。このパラメーターにより、追加のユーザー情報（例: 顧客名）を指定できます。
パラメーターは次の形式で指定する必要があります: TransactionParameters={“key”: “string_1”,”value”:”string”}&TransactionParameters={“key”: “string_2”,”value”:”string”}
DocumentParametersキーと値の文字列ペアで構成されるドキュメントパラメーターの一覧。このパラメーターにより、追加のドキュメント情報（例: ファイル名）を指定できます。
パラメーターは次の形式で指定する必要があります: DocumentParameters={“key”: “string_1”,”value”:”string”}&DocumentParameters={“key”: “string_2”,”value”:”string”}
Offsetページネーションのオフセット。
このパラメーターの既定値は 0 です。
Limitページネーションの上限値。必須のパラメーターです。
このパラメーターの既定値は 0 です。
レスポンスには、すべての完了したトランザクションと、次の例のような処理されたページ数を含む JSON ファイルが返されます。 
{
  "items": [
    {
      "status": "FinishedSuccessfully",
      "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": "FinishedSuccessfully",
      "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": "FinishedSuccessfully",
      "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": "FinishedSuccessfully",
      "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": "FinishedSuccessfully",
      "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
}