メインコンテンツへスキップ
Vantage Mobile Upload は、API 呼び出しを使用して Vantage サーバーと通信します。これらの呼び出しは、documents の作成、画像のアップロード、特定のパラメーターによるトランザクション処理の開始に使用されます。

プラットフォーム別の API 呼び出し

iOS プラットフォーム

Vantage Mobile Input の iOS マイクロアプリケーションは、次の API 呼び出しを使用します:
  1. 入力セッションのパラメーターを Vantage Mobile Upload Backend に送信する
  2. 入力セッションのパラメーターを Vantage Mobile Upload Backend から取得する
  3. トランザクションのステータスを取得する
  4. ドキュメント画像を分析するためのモデルをダウンロードする
  5. トランザクション内の documents の一覧を取得する
  6. トランザクション内の既存の documents を削除する
  7. トランザクション内に Document を作成する
  8. 取得した画像を Document にアップロードする
  9. トランザクションを開始する

Android プラットフォーム

Vantage Mobile Input の Android マイクロアプリは、次の API 呼び出しを使用します:
  1. トランザクションのステータス取得
  2. ドキュメント画像を解析するためのモデルのダウンロード
  3. トランザクション内のドキュメント一覧の取得
  4. トランザクション内の既存ドキュメントの削除
  5. トランザクション内でのドキュメントの作成
  6. ドキュメントへの撮影画像のアップロード
  7. トランザクションの開始

Vantage Mobile Upload Backend への入力セッション Parameter の送信

Vantage Mobile Input は、入力セッション Parameter を Vantage Mobile Upload Backend に送信します。これらの Parameter は、Android のマイクロアプリケーションまたは Web ブラウザーでのアップロードセッションに使用されます。

入力セッションのパラメーター

KeyDescription
BaseURLVantage server のメインドメイン。
TransactionIDトランザクションの識別子。
TokenVantage API への認証済みアクセスに使用される、エンコードされた access token。
vVantage API のバージョン。
md1 つのトランザクションで抽出される文書数。
redirect_uriVantage Mobile Upload の完了後に開くリダイレクトリンク。
dt文書タイプ。
maオンプレミス環境で micro applications を起動するために使用される、ABBYY Vantage クラウド環境のアドレス。
リクエスト:
レスポンス:

Vantage Mobile Upload Backend から入力セッションのパラメータを取得する

入力セッションのパラメータを取得するため、Vantage Mobile Upload は Vantage Mobile Upload Backend にリクエストを送信します。

入力セッションのパラメーター

キー説明
BaseURLVantage serverのメインドメインです。
TransactionIDトランザクションの識別子です。
TokenVantage API への認証済みアクセスに使用される、エンコードされたアクセス トークンです。
vVantage API のバージョンです。
md1 つのトランザクションで取り込まれる文書数です。
redirect_uriVantage Mobile Upload の完了後に開くリダイレクト先のリンクです。
dt文書タイプです。
maオンプレミス環境でマイクロアプリケーションを開始するために使用される、ABBYY Vantage クラウド環境のアドレスです。
リクエスト:
レスポンス:
input session パラメーターの例:

トランザクションのステータスの取得

Vantage Mobile Upload は、トランザクションの識別子とステータスを取得するためのリクエストを送信します。ドキュメントをアップロードできるのは、ステータスが New のトランザクションのみです。 主なパラメーター
キー説明
TransactionIDトランザクションの識別子です。
Statusトランザクションのステータスです。使用できる値: New, Started, Processing, Processed
リクエスト: レスポンス:

文書画像の分析用モデルのダウンロード

Vantage Mobile Upload は、iOS マイクロアプリケーション用に、文書画像内のページの端を検出するためのモデルをダウンロードするリクエストを送信します。 主なパラメーター
キー説明
AbbyyRtrSDK-version関連するパターンファイルのリクエストに使用する AbbyyRtrSDK フレームワークのバージョンです。値は Vantage のバージョンに応じて変わる場合があります。
PatternFileName文書画像内のページの端を検出するために使用される AbbyyRtrSDK のファイルパターン名です。ファイルパターンには 6 種類あります: FactCrop.imodel, CnnCrop.Classifier.cnnmodel, DIQClassifier.imodel, CnnCrop.Detector.GenericWithID.cnnmodel, DIQBlockClassifier.imodel, CropClassifierPhoto.imodel
リクエスト: レスポンス:

トランザクション内のドキュメント一覧の取得

Vantage Mobile Upload は、ドキュメントをトランザクションにアップロードする前に、トランザクション内に以前作成されたドキュメントがあるかどうかを確認するリクエストを送信します。トランザクションが空でない場合、Vantage Mobile Upload は新しいアップロードセッションを開始する前に、既存のすべてのドキュメントを削除するための Delete document リクエストを送信します。 主なパラメーター
キー説明
TransactionIDトランザクションの識別子です。
DocumentIDCreating a document リクエストで取得したドキュメントの識別子です。
SourceFileID文書画像の識別子です。
SourceFileName文書画像の名前です。Vantage Mobile Upload は各画像のファイル名を自動生成し、Uploading Images to the document リクエストを使用してその画像をドキュメントにアップロードします。
リクエスト: レスポンス:

トランザクション内の既存documentsの削除

処理を開始する前にトランザクションからdocumentsを削除するには、DELETE /api/publicapi/v1/transactions/{transactionId}/documents/{documentId} を使用します。 これにより、ユーザーは次のことが可能になります:
  • 誤って取り込まれたdocumentsを削除する
  • 再取り込み前にdocumentsを消去する
  • トランザクション内のdocumentsセットを管理する
documentsは、トランザクションの処理開始前にのみ削除できます。

トランザクション内でドキュメントを作成する

画像をアップロードする際、Vantage Mobile Upload は、トランザクション内の各ドキュメントに対してドキュメントインスタンスを作成するリクエストを送信します。 主なパラメーター
KeyDescription
TokenVantage API への認証済みアクセスに使用する、エンコードされたアクセストークン。
TransactionIDトランザクションの識別子。
DocumentIDドキュメントの識別子。
リクエスト: レスポンス:

撮影した画像を文書にアップロードする

文書インスタンスが作成されると、Vantage Mobile Upload はすべての画像を文書にアップロードするリクエストを送信します。1 つの文書に含まれるすべての画像は、1 回のリクエストでアップロードされます。 主なパラメーター
キー説明
TokenVantage API への認証済みアクセスに使用する、エンコードされたアクセストークン。
TransactionIDトランザクションの識別子。
DocumentIDCreating a document リクエストで受け取った文書の識別子。
SourceFileID文書画像の識別子。
SourceFileName文書画像の名前。Vantage Mobile Upload は各画像のファイル名を自動生成し、画像を文書にアップロードします。
ImageData画像ファイルのエンコードされたデータ。文書に画像をアップロードするために使用されます。
リクエスト: レスポンス:

トランザクションの開始

すべてのドキュメントが作成され、すべての画像がドキュメントにアップロードされると、Vantage Mobile Upload はトランザクションを開始するためのリクエストを送信します。 主なパラメーター
Key説明
TokenVantage API への認証済みアクセスに使用される、エンコードされた認可アクセストークン。
TransactionIDトランザクションの識別子。
リクエスト: レスポンス: