--- title: File url: ja/amazon-pay-api-v2/ja-file.html --- * TOC {:toc} {::options toc_levels="3" /} *** サポートされる操作: ### File Object
プロパティ
説明
id

型: string
ファイルを参照するための一意な識別子
type

型: filetype [Enum]
ファイル形式（例: jpg、pdf など）
purpose

型: filePurpose [Enum]
ファイルの利用目的（例: disputeEvidence）
size

型: int
ファイルサイズ（バイト単位）
uploadTimestamp

型: dateTime
ISO 8601形式でのアップロード日時
url

型: String
ファイルのダウンロードURL
urlExpirationTimestamp

型: dateTime
ダウンロードURLの有効期限
#### Enum #### **filePurpose**
値
説明
disputeEvidence
提供されたファイルはディスピュート（異議申し立て）の証拠として使用されます
### Upload File 詳細 紛争証拠やその他の文書作成に必要なファイルをアップロードして管理します。Upload File APIは、一般的なファイル形式をサポートし、安全なアップロードURLを提供します。APIは、ファイルを安全にアップロードするための2段階のプロセスを提供します。 #### Step 1: Upload URL取得 まず安全なアップロードURLをリクエストします。: #### Request #### Request body ``` { "type" : "jpg", "purpose" : "disputeEvidence" } ``` #### Request parameters
名前
ロケーション
説明
x-amz-pay-idempotency-key
(required)

Type: String
Header
重複アップロードを防ぐための一意のキー。idempotencyキーの作成と使用に関する詳しいガイダンスについては、別途idempotencyを参照してください。
type

Type: String
Body
ファイルフォーマット(jpg, png, pdf)
purpose

Type: String
Body
アップロード理由(disputeEvidence)
#### Supported file types
ファイルタイプ
 説明
 Content-Type
csv
 CSV files
 text/csv
pdf
 PDF documents
 application/pdf
xls/xlsx
 Excel spreadsheets
 application/vnd.ms-excel (xls)
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (xlsx)
doc/docx
 Word documents
 application/msword (doc)
application/vnd.openxmlformats-officedocument.wordprocessingml.document (docx)
ods
 OpenDocument spreadsheets
 application/vnd.oasis.opendocument.spreadsheet
jpg/png
 Image files
 image/jpeg (jpg)
image/png (png)
#### Response ``` { "id": "file_sdcjscbjckndjhckj", "type" : "jpg", "purpose": "disputeEvidence", "uploadTimestamp": "20190714T155300Z", "url": "https://pay-api.amazon.jp/v1/files/file_sdcjscbjckndjhckj/contents", "urlExpirationTimeStamp": "20190714T155300Z" } ``` #### Step 2: ファイルアップロード レスポンスにあるURLにファイルを送信します：: curl "YOUR_PRESIGNED_URL" \
-X PUT \
-H "Content-Type: application/pdf" \
-T "/path/to/file"
ファイル要件： * 最大サイズ：2MB * ファイルは紛争の証拠として関連性があるものでなければなりません アップロード後、Upload File APIのレスポンスにある fileId を使用します。