サーバーにファイルをアップロードする

PUT または POST リクエスト、MD5 ハッシュ検証、multipart のサポートにより、Mobile API 経由で ABBYY FlexiCapture サーバーに画像をアップロードします。

サーバーにファイルをアップロードするには、PUT または POST リクエストを使用します。

​

PUT リクエストを作成する

PUT リクエストでファイルをアップロードするには、次の URI を指定します。

https://localhost/flexicapture12/server/MobileApp?filename=[file name]&projectName=[project name]&batchType=[batch name]

URI は次のパラメーターを受け取ります。

Parameter	Description
projectName	project の名前です。必須です。
batchType	バッチの名前です。必須です。値が指定されていない場合は、既定のバッチタイプが使用されます。
filename	アップロードするファイルの名前です。必須です。

PUT リクエストで登録パラメーターを渡すことはできません。詳細については、「バッチの構造を指定する」を参照してください。

Content-Type ヘッダーフィールドの値を明示的に指定し、アップロードするファイルを PUT リクエストの body に配置します。

サーバーはハッシュ化もサポートしています。ファイルの MD5 ハッシュ値を UTF-16LE を使用して Base64 でエンコードし、その後、標準の Content-MD5 ヘッダーで渡します。

サーバーはファイルの独自のハッシュ値を計算し、ヘッダーの値と比較します。2 つの値が一致しない場合、サーバーはファイルを削除します。

サーバーから返されるレスポンスは 2 種類あります。

• HTTP 201 (Created) – ファイルは正常にサーバーにアップロードされました。
• HTTP 400 (Bad request) – 必須パラメーターが不足しているか、ハッシュ関数の値がヘッダーで指定された値と一致していません。ファイルはアップロードされませんでした。

​

POST リクエストの作成

PUT リクエストを使用できる場合は、使用してください。PUT を使用できない場合は、代わりに POST リクエストでファイルをアップロードしてください。projectName パラメーターと batchType パラメーターは、PUT リクエストの場合と同様に URL で渡すか、リクエスト本文内のテキストの field として渡します。

​

1 つのリクエストで複数の画像を渡す

1 つの POST リクエストで複数の画像を渡すことができます。Content-Type ヘッダーフィールドの値を multipart/form-data に設定し、boundary パラメーターで separator の値を指定します。リクエストに含まれるファイル名は同一であってはなりません。

次の例では、1 つのリクエストで 2 つのファイルを渡しています。

Content-type: multipart/form-data; boundary=<random string>
--<boundary value>
Content-Disposition: form-data; name=<field name>; filename=<name of file 1><crlf>
Content-MD5: <value of MD5 hash for file><crlf>
<crlf>
<file data>
--<boundary value>
Content-Disposition: form-data; name=<field name>; filename=<name of file 2><crlf>
<crlf>
<file data>

​

テキストの field を渡す

POST リクエストでテキストの field を渡すこともできます:

--<boundary value>
Content-Disposition: form-data; name="<field name>"<crlf>
<crlf>
<field value><crlf>

次の boundary 文字列でリクエストを終了します:

--<boundary value>--<crlf><crlf>