メインコンテンツへスキップ
ABBYY Vantage では、モバイルデバイスからドキュメントを直接キャプチャ、処理、アップロードできる Vantage Mobile Input 機能を使用できます。 Vantage Mobile Input は、Vantage API を介してモバイルアップロードリンクを取得することから開始します。このリンクには、モバイル入力セッション中にキャプチャするドキュメントの数や種類、アップロードされたドキュメントを処理する ABBYY Vantage の Skill などを定義するパラメーターが含まれます。Vantage API の使用方法の詳細については、Swagger ドキュメントを参照してください。 モバイルアップロードリンクは、モバイル入力セッションを開始するために使用できます。
  • iOS および Android 向けのマイクロアプリケーション、または Web ブラウザーから。
  • ネイティブ iOS および Android アプリケーションから。
Vantage Mobile Input 機能を使用するためにトランザクション用のモバイルアップロードリンクを取得するには、次の手順を実行します。
  1. ABBYY Vantage に対して認証を行います(詳細な手順については、Authentication を参照してください)。
注: ABBYY Vantage への各 HTTP リクエストには、サービスがシステム内のユーザーを識別するために使用するアクセストークンを含むヘッダーが必要です。
  1. 利用可能な Skill の一覧を表示し、ドキュメントを処理するために必要な Skill の ID を見つけます。
そのためには、GET リクエストを skills リソースに送信します。
GET https://your-server/api/publicapi/v1/skills
次のコマンドを実行します。 Windows の場合:
curl -X GET "https://your-server/api/publicapi/v1/skills" \
-H "Authorization: Bearer token"
Linux の場合:
curl -X GET 'https://your-server/api/publicapi/v1/skills' \
-H 'Authorization: Bearer token'
その結果、アカウントで利用可能なすべての Skill の情報が返されます。
  1. 空のトランザクションを作成するには、POST リクエストを transactions リソースに送信し、リクエスト本文で skillId パラメーターを指定します。そのトランザクション用のモバイルアップロード用リンクを取得するには、リクエスト本文に generateMobileInputLink パラメーターを追加し、その値を true に設定します。
POST https://your-server/api/publicapi/v1/transactions
次のコマンドを実行してください: Windows の場合:
curl -X POST "https://your-server/api/publicapi/v1/transactions" \
-H "Authorization: Bearer token" \
-H "Content-Type: application/json" \
-d "{\"skillId\":\"123\", \"generateMobileInputLink\": true}"
Linux の場合:
curl -X POST 'https://your-server/api/publicapi/v1/transactions' \
-H 'Authorization: Bearer token' \
-H 'Content-Type: application/json' \
-d '{"skillId":"123", "generateMobileInputLink": true}'
トランザクションが正常に作成されると、トランザクション識別子とモバイルアップロード用リンクを含むレスポンスが返されます。 レスポンス:
{
   "transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
   "mobileInputLink": "https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&token=<token>&v=<2.4>" 
}
リンクは30分間有効で、その後は新しいリンクを取得する必要があります。 注: Web サイト上でドキュメントをアップロードするために QR コードやボタンを使用している場合には、これらの QR コードおよびボタンが新しいトランザクションを作成し、かつ/または 30 分ごとにトークンを更新するように設定することをお勧めします。そうしないと、最初に発行されたトークンの有効期限が切れた後、ユーザーはドキュメントをアップロードできなくなります。 取得したリンクを使用して、Vantage API で Vantage Mobile Input を起動し、追加のパラメーターを設定し、処理を追跡して結果をダウンロードできます。iOS および Android 用マイクロアプリケーションを使用して、モバイルデバイスでドキュメントを撮影し、ドキュメントをアップロードする方法についての手順は、クイックスタートガイドの「モバイルデバイスからのドキュメントアップロード」セクションに記載されています。