Files / Upload init
Request upload of file (allowed unauthorized)
Route: /api/{tenant:minlength(2)}/v{version:apiVersion}/files/upload_init
Method: POST
Authorisation: No authentication needed
Response object
Response status: 200 (OK)
Response type: DTO_file_upload_init_response[]
Wrapper: DTO_response_wrap
Other response statuses: 400 (BadRequest), 403 (Forbidden)
Response body example
DTO_file_upload_init
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| filename | String | Filename | |
| size_bytes | Int64 | Size bytes | |
| hash_md5 | String | Hash md5 |
DTO_file_upload_init_response
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| file_id | Int32 | File id | |
| filename | String | To idenfity file in a collection of upload requests | |
| md5 | String | Md5 | |
| signed_upload_url | String | Signed upload url | |
| status | ENUM file_upload_init_status | Status |
ENUM file_upload_init_status
| Value | Name | Description |
|---|---|---|
| 0 | UNKNOWN | UNKNOWN |
| 1 | UPLOAD | Upload |
| 2 | EXIST_SKIP_UPLOAD | Exist, skip upload |