PUT リクエストを作成する
PUT リクエストでファイルをアップロードするには、次の URI を指定します。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 つのファイルを渡しています。