メインコンテンツへスキップ
単一の API コールを使用してドキュメントを処理する (トランザクションの作成、ファイルのアップロード、およびトランザクションの開始) ための一般的なシナリオは、次の手順で構成されます。
  1. 利用可能なすべての Skill の一覧を取得する
  2. トランザクションを作成して開始する
  3. トランザクションのステータスを監視する
  4. ソースファイルと結果ファイルをダウンロードする
サーバーへの各リクエストには、認証情報を含める必要があります。詳細は、Authentication を参照してください。 このシナリオは、サイズが 30 MB 未満のファイルが 1 つだけであり、そのファイル内の画像を編集する必要がない場合に使用してください。

​
利用可能なすべてのSkillの一覧を取得する

これを行うには、skills リソースに GET リクエストを送信します。 次のコマンドを実行します。 Windows の場合: Linux の場合: レスポンスには、次のような JSON ファイルが含まれます。 レスポンス:
使用するSkill識別子を指定します。Skillの詳細な説明は、組み込みSkillに記載されています。

​
トランザクションの作成と開始

指定した Skill でアップロード済みのファイルを処理するトランザクションを作成して開始するには、次の POST リクエストを transactions/launch?skillId=<skill-id> リソースに送信します。 これにより、新しいトランザクションが作成され、すぐに開始されます。 次のコマンドを実行します。 Windows の場合: Linux の場合:
ファイルを Vantage にアップロードする際、ファイル名に含まれる次の文字はすべてアンダースコアに置き換えられます: :/?#[]@!$&'()*+,;=\。変更後のファイル名は、Vantage API と Skill Monitor の両方に表示されます。

​
トランザクションのステータスを監視する

短いタイムアウトを設定したループを使用してトランザクションのステータス監視を開始するには (ステータス確認の頻度は 1 秒に 1 回を超えないことを推奨します) 、リクエスト URI にトランザクション識別子を指定して、transactions/<transaction_id> リソースに GET リクエストを送信します。 次のコマンドを実行します。 Windows の場合: Linux の場合: レスポンスは次のようになります。 レスポンス: レスポンスでは、次の点に注意してください。
  • status キーの値が Processing の場合、結果はまだ準備できていません。トランザクションのステータスが Processed に変わると、結果をダウンロードできるようになります。
  • manualReviewLink キーには、手動確認クライアントの Web インターフェイスへのリンクと、手動確認が必要な場合は Vantage の access token が含まれます。このリンクとトークンを使用すると、特定のトランザクションの分類結果およびフィールド抽出結果を確認して修正できます。確認が完了するまで、status キーの値は Processing に設定されます。提供されるリンクの有効期間は 168 時間です。期限切れ後は、同じ方法でさらに 168 時間有効な新しいリンクを作成して取得する必要があります。詳細は 手動確認の統合 を参照してください。
このリンクを使用して認証されたユーザーは、他のドキュメントやトランザクションを表示または変更できません。
Document skill の場合、レスポンスは次のようになります。 レスポンス: documents array では、各ドキュメントに resultFiles array があります。この array を使用して fileId の値を取得します。出力ファイルの形式は、使用する skill によって決まります。現在、すべての Skill は JSON 形式 で抽出されたフィールドを返します。 分類スキルの場合、ドキュメントの処理後に受信するレスポンスは次のようになります。 レスポンス: resultClass キーからドキュメントのクラスを取得し、confidence キーで各候補クラスの信頼度を確認します。 Process skill の場合、レスポンスには、Process skill で利用可能なステージに応じて、Document skill および分類スキルで返される情報の全部または一部が含まれることがあります。

​
ソースファイルと結果ファイルのダウンロード

処理の完了後、2 種類のファイルをダウンロードできます。
  • ソースファイル — アップロードした元のファイルです。元のバイナリ形式で返されます。
  • 結果ファイル — 処理結果です。既定では、抽出データが JSON 形式 で返されます (出力形式は Skill で設定されます)。
ソースファイルと結果ファイルでは、それぞれ異なる endpoint と異なるファイル識別子を使用します。
  • ソースファイル — GET transactions/<transaction-id>/documents/<document-id>/sourceFiles/<file-id>/download。ファイル ID は、GET transactions/<transaction-id>/documents のレスポンス (sourceFiles[].id) から取得します。
  • 結果ファイル — GET transactions/<transaction-id>/files/<file-id>/download。ファイル ID は、transaction status のレスポンス内の resultFiles 配列 (documents[].resultFiles[].fileId) から取得します。
識別子付きのドキュメント一覧を取得するには、transactions/<transaction-id>/documents リソースに GET リクエストを送信し、トランザクション識別子を指定します。 次のコマンドを実行します。 Windows の場合: Linux の場合:

​
ソースファイル

必要なソースファイルをダウンロードするには、transactions/<transaction-id>/documents/<document-id>/sourceFiles/<file-id>/download リソースに GET リクエストを送信し、トランザクション、ドキュメント、およびファイルの識別子 (直前のレスポンスから取得) を指定します。 次のコマンドを実行します。 Windows の場合: Linux の場合: レスポンスにはファイルがバイナリ形式で含まれます。すべてのソースファイルについて、この手順を繰り返します。

​
結果ファイル

結果ファイルをダウンロードするには、transactions/<transaction-id>/files/<file-id>/download リソースに GET リクエストを送信し、トランザクション識別子と結果ファイルの fileId を指定します。fileId は、トランザクションステータスの監視 時に返される resultFiles 配列から取得します (各エントリには fileId と type (Json など) が含まれます) 。 次のコマンドを実行します。 Windows の場合: Linux の場合: