创建上传链接

POST

/v1/files/upload

创建文件上传链接。

步骤：

调用此接口获取 upload_url（预签名 OSS 链接）

使用 PUT 方法直接上传文件到 upload_url

调用 POST /v1/files/upload/complete 确认上传

参数：

file_name — 文件名（必填）

file_size — 文件大小（可选）

请求参数

Authorization

API Key

在 header 添加参数

app-key

示例：

app-key: ********************

Header 参数

Body 参数application/json必填

示例

{
    "file_name": "string",
    "file_size": 0,
    "content_type": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.jieshuo.cn/v1/files/upload' \
--header 'x-code;' \
--header 'app-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "file_name": "string",
    "file_size": 0,
    "content_type": "string"
}'

返回响应

🟢200OK

application/json

Successful Response

Bodyapplication/json

示例

{
    "code": 10000,
    "message": "Success",
    "data": {
        "file_id": "string",
        "file_name": "string",
        "file_hash": "string",
        "upload_url": "string",
        "oss_key": "string",
        "expires_in": 3600
    }
}

🟠422Parameter Error

修改于 2026-07-10 07:58:12

删除文件

批量删除文件