[WORK:FILE:DOCUMENT:WRITE] 创建文件上传会话

测试环境

http://test-cn.your-api-server.com

POST

/api/v1/work/files

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "filename": "string",
    "content_type": "application/pdf",
    "byte_size": 1,
    "brand_id": "string",
    "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://test-cn.your-api-server.com/api/v1/work/files' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "filename": "string",
    "content_type": "application/pdf",
    "byte_size": 1,
    "brand_id": "string",
    "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e"
}'

返回响应

🟢200

application/json

Successful Response

Bodyapplication/json

示例

{
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "code": "W200",
    "msg": "成功",
    "errors": [],
    "data": {
        "document": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "filename": "string",
            "content_type": "string",
            "byte_size": 0,
            "status": "string",
            "brand_id": "string",
            "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e"
        },
        "upload_url": "string",
        "access": "string",
        "expires_in": 0
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🟠413PayloadTooLarge

🟠422UnprocessableEntity

🟠429TooManyRequests

🔴500InternalError

修改于 2026-08-31 17:36:55

[WORK:IAM:SELF:UPDATE] 删除通知 Webhook

[WORK:FILE:DOCUMENT:WRITE] 完成上传