> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Vantage API を使用してモバイルデバイスからドキュメントをアップロード
> ABBYY Vantage Mobile Input API を使用してモバイルアップロードリンクを生成し、スマートフォンでドキュメントを取り込み、処理のために Vantage に直接送信します。
ABBYY Vantage では、モバイルデバイスからドキュメントを直接キャプチャ、処理、アップロードできる Vantage Mobile Input 機能を使用できます。
Vantage Mobile Input は、Vantage API を介してモバイルアップロードリンクを取得することから開始します。このリンクには、モバイル入力セッション中にキャプチャするドキュメントの数や種類、アップロードされたドキュメントを処理する ABBYY Vantage の Skill などを定義するパラメーターが含まれます。Vantage API の使用方法の詳細については、お使いのリージョンの Swagger ドキュメントを参照してください：[US](https://vantage-us.abbyy.com/api/index.html?urls.primaryName=publicapi%2Fv1)、[EU](https://vantage-eu.abbyy.com/api/index.html?urls.primaryName=publicapi%2Fv1)、または [AU](https://vantage-au.abbyy.com/api/index.html?urls.primaryName=publicapi%2Fv1)。
モバイルアップロードリンクは、モバイル入力セッションを開始するために使用できます。
* iOS および Android 向けのマイクロアプリケーション、または Web ブラウザーから。
* ネイティブ iOS および Android アプリケーションから。
Vantage Mobile Input 機能を使用するためにトランザクション用のモバイルアップロードリンクを取得するには、次の手順を実行します。
1. ABBYY Vantage に対して認証を行います (詳細な手順については、[Authentication](/ja/vantage/developer/authentication/authentication) を参照してください) 。
ABBYY Vantage への各 HTTP リクエストには、サービスがシステム内のユーザーを識別するために使用するアクセストークンを含むヘッダーが必要です。
2. 利用可能な Skill の一覧を表示し、ドキュメントを処理するために必要な Skill の ID を見つけます。
そのためには、`GET` リクエストを `skills` リソースに送信します。
```text US theme={null}
GET https://vantage-us.abbyy.com/api/publicapi/v1/skills
```
```text EU theme={null}
GET https://vantage-eu.abbyy.com/api/publicapi/v1/skills
```
```text AU theme={null}
GET https://vantage-au.abbyy.com/api/publicapi/v1/skills
```
次のコマンドを実行します。
**Windows の場合:**
```bash US theme={null}
curl -X GET "https://vantage-us.abbyy.com/api/publicapi/v1/skills" \
-H "Authorization: Bearer token"
```
```bash EU theme={null}
curl -X GET "https://vantage-eu.abbyy.com/api/publicapi/v1/skills" \
-H "Authorization: Bearer token"
```
```bash AU theme={null}
curl -X GET "https://vantage-au.abbyy.com/api/publicapi/v1/skills" \
-H "Authorization: Bearer token"
```
**Linux の場合:**
```bash US theme={null}
curl -X GET 'https://vantage-us.abbyy.com/api/publicapi/v1/skills' \
-H 'Authorization: Bearer token'
```
```bash EU theme={null}
curl -X GET 'https://vantage-eu.abbyy.com/api/publicapi/v1/skills' \
-H 'Authorization: Bearer token'
```
```bash AU theme={null}
curl -X GET 'https://vantage-au.abbyy.com/api/publicapi/v1/skills' \
-H 'Authorization: Bearer token'
```
レスポンスには、利用可能な Skill の一覧を含む JSON ファイルが含まれます。Skill 識別子を見つけて、トランザクションを作成するための `skillId` パラメーターの値として使用します。
**レスポンス:**
```json theme={null}
[
{
"id": "c4b26798-07cb-11eb-adc1-0242ac120002",
"name": "NewClassifier",
"type": "Classification"
},
{
"id": "c4b26798-07cb-11eb-adc1-0242ac120002",
"name": "Invoice",
"type": "Document"
}
]
```
3. 空のトランザクションを作成するには、`POST` リクエストを `transactions` リソースに送信し、リクエスト本文で `skillId` パラメーターを指定します。そのトランザクション用のモバイルアップロードリンクを取得するには、リクエスト本文に `generateMobileInputLink` パラメーターを追加し、その値を `true` に設定します。
```text US theme={null}
POST https://vantage-us.abbyy.com/api/publicapi/v1/transactions
```
```text EU theme={null}
POST https://vantage-eu.abbyy.com/api/publicapi/v1/transactions
```
```text AU theme={null}
POST https://vantage-au.abbyy.com/api/publicapi/v1/transactions
```
次のコマンドを実行します。
**Windows の場合:**
```bash US theme={null}
curl -X POST "https://vantage-us.abbyy.com/api/publicapi/v1/transactions" \
-H "Authorization: Bearer token" \
-H "Content-Type: application/json" \
-d "{\"skillId\":\"123\", \"generateMobileInputLink\": true}"
```
```bash EU theme={null}
curl -X POST "https://vantage-eu.abbyy.com/api/publicapi/v1/transactions" \
-H "Authorization: Bearer token" \
-H "Content-Type: application/json" \
-d "{\"skillId\":\"123\", \"generateMobileInputLink\": true}"
```
```bash AU theme={null}
curl -X POST "https://vantage-au.abbyy.com/api/publicapi/v1/transactions" \
-H "Authorization: Bearer token" \
-H "Content-Type: application/json" \
-d "{\"skillId\":\"123\", \"generateMobileInputLink\": true}"
```
**Linux の場合:**
```bash US theme={null}
curl -X POST 'https://vantage-us.abbyy.com/api/publicapi/v1/transactions' \
-H 'Authorization: Bearer token' \
-H 'Content-Type: application/json' \
-d '{\"skillId\":\"123\", \"generateMobileInputLink\": true}'
```
```bash EU theme={null}
curl -X POST 'https://vantage-eu.abbyy.com/api/publicapi/v1/transactions' \
-H 'Authorization: Bearer token' \
-H 'Content-Type: application/json' \
-d '{\"skillId\":\"123\", \"generateMobileInputLink\": true}'
```
```bash AU theme={null}
curl -X POST 'https://vantage-au.abbyy.com/api/publicapi/v1/transactions' \
-H 'Authorization: Bearer token' \
-H 'Content-Type: application/json' \
-d '{\"skillId\":\"123\", \"generateMobileInputLink\": true}'
```
トランザクションが正常に作成されると、トランザクション識別子とモバイルアップロードリンクを含むレスポンスを受け取ります。
**レスポンス:**
```json US theme={null}
{
"transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mobileInputLink": "https://vantage-us.abbyy.com/mobile?baseUrl=&transactionId=&token=&v=<2.4>"
}
```
```json EU theme={null}
{
"transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mobileInputLink": "https://vantage-eu.abbyy.com/mobile?baseUrl=&transactionId=&token=&v=<2.4>"
}
```
```json AU theme={null}
{
"transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"mobileInputLink": "https://vantage-au.abbyy.com/mobile?baseUrl=&transactionId=&token=&v=<2.4>"
}
```
リンクは30分間有効で、その後は新しいリンクを取得する必要があります。
Web サイト上でドキュメントをアップロードするために QR コードやボタンを使用している場合には、これらの QR コードおよびボタンが新しいトランザクションを作成し、かつ/または 30 分ごとにトークンを更新するように設定することをお勧めします。そうしないと、最初に発行されたトークンの有効期限が切れた後、ユーザーはドキュメントをアップロードできなくなります。
取得したリンクを使用して、Vantage API で Vantage Mobile Input を起動し、[追加のパラメーターを設定](/ja/vantage/developer/mobile-upload/configuring-input)し、[処理を追跡して結果をダウンロード](/ja/vantage/developer/mobile-upload/tracking-processing)できます。iOS および Android 用マイクロアプリケーションを使用して、モバイルデバイスでドキュメントを撮影し、ドキュメントをアップロードする方法についての手順は、クイックスタートガイドの「モバイルデバイスからのドキュメントアップロード」セクションに記載されています。