> ## 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.

# Web Services API への接続

> SOAP、JSON、または POST リクエストを介して ABBYY FlexiCapture Web Services API に接続し、Windows または FlexiCapture アカウントで認証します。

API を使用するには、まず Web サービスに接続する必要があります。この接続を確立できるのは、「User station」(ID=10) [ワークステーション タイプ](/ja/flexi-capture/api/structures/t-workstation-type) 上の「Scanning Operator」(ID=1) [ロール](/ja/flexi-capture/api/structures/t-role-type) です。

<div id="the-apis">
  ## API
</div>

ABBYY FlexiCapture 12 Application Server の Web Services API は、SOAP リクエスト、JSON リクエスト、または POST リクエストを使用して利用できます。アクセス先のインターフェイスは、Web サービスのアドレスによって決まります。

| **メソッド**                                        | **使用する場合**                                                                            | **Handler 値**      |
| ----------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------ |
| SOAP リクエスト                                      | あらゆる操作に使用できます                                                                         | .../API/v1/Soap    |
| JSON リクエスト                                      | あらゆる操作に使用できます                                                                         | .../API/v1/Json    |
| [POST リクエスト](/ja/flexi-capture/api/files/files) | サーバーへのファイルのアップロード、ファイルの分割アップロード、チェックサムの取得、サーバーからのファイルのダウンロードなど、ファイル操作を効率化するために使用できます。 | .../FileService/v1 |

<div id="authentication-methods">
  ## 認証メソッド
</div>

ABBYY FlexiCapture 12 では、Windows アカウントまたは ABBYY FlexiCapture アカウントを使用して Web Services API に接続できます。

Windows アカウントでは、次の 2 つのオプションがあります。

* Windows 認証: NTLM または Negotiate
* Basic 認証: username と password を Base64 エンコードした文字列 `"username:password"` として渡します

ABBYY FlexiCapture アカウントの場合は、Web サービス URL に "/FCAuth" を追加します。最初は Basic 認証を使用してください。service の呼び出しが 1 回正常に完了すると、応答には認可トークンを含む AuthTicket ヘッダーが返されます。このトークンは、同じマシンからの後続の request で Bearer 認証を使用する際に利用できます。

<Note>
  tenant を指定するには、API 接続アドレスの末尾に **?Tenant=MyTenantName** 形式のサフィックスを追加します。
</Note>

<Accordion title="異なる認証メソッドに対応する Web サービス アドレスの例">
  |            | Windows アカウント                                                       | ABBYY FlexiCapture アカウント                                                   |
  | ---------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------- |
  | SOAP リクエスト | https\:// \<ApplicationServer>/FlexiCapture12/Server/API/v1/Soap    | https\:// \<ApplicationServer>/FlexiCapture12/Server/FCAuth/API/v1/Soap    |
  | JSON リクエスト | https\:// \<ApplicationServer>/FlexiCapture12/Server/API/v1/Json    | https\:// \<ApplicationServer>/FlexiCapture12/Server/FCAuth/API/v1/Json    |
  | POST リクエスト | https\:// \<ApplicationServer>/FlexiCapture12/Server/FileService/v1 | https\:// \<ApplicationServer>/FlexiCapture12/Server/FCAuth/FileService/v1 |
</Accordion>