Overview
API Endpoint
POST /files-api/v1/upload
Request Parameters
| Field | Subfield | Input Type | Required | Length Limit | Description / Rules |
|---|---|---|---|---|---|
| file | string | Yes | Uploaded file, using multipart/form-data | ||
| purpose | string | Yes | 1-50 | File purpose, enum value. Currently only supports: dispute_evidence |
Response Parameters (HTTP Code 200)
| Level 1 Field | Level 2 Field | Level 3 Field | Level 4 Field | Type | Description |
|---|---|---|---|---|---|
| code | string | API result code, 200, 400, 500 | |||
| msg | string | Result description, e.g. PARAM_ERROR | |||
| data | object | Node | |||
| files | object | Node | |||
| id | string | File ID | |||
| filename | string | File name | |||
| size | string | File size in bytes | |||
| type | string | File MIME type | |||
| purpose | string | File purpose | |||
| created | string | Creation time, converted timestamp, UTC+8 format: 2026-04-02T16:28:09+08:00 | |||
| result_code | string | Returned response code | |||
| result_message | string | Returned response message |