跳转到主要内容
POST
/
files
/
upload
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "size": 123,
  "extension": "<string>",
  "mime_type": "<string>",
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": 123
}

Authorizations

​
Authorization
string
header
required

API-Key 鉴权。所有 API 请求都应在 Authorization HTTP Header 中包含你的 API-Key，格式为 Bearer {API_KEY}。强烈建议开发者把 API-Key 放在后端存储，而非分享或者放在客户端存储，以免 API-Key 泄露，导致财产损失。

Body

multipart/form-data

文件上传请求，需使用 multipart/form-data。

​
file
file
required

要上传的文件。支持的图片类型：png, jpg, jpeg, webp, gif。

​
user
string
required

用户标识，由开发者定义规则，需保证用户标识在应用内唯一，必须和发送消息接口传入 user 保持一致。

Response

文件上传成功。

文件上传成功后的响应。

​
id
string<uuid>

ID。

​
name
string

文件名。

​
size
integer

文件大小（byte）。

​
extension
string

文件后缀。

​
mime_type
string

文件 mime-type。

​
created_by
string<uuid>

上传人 ID (示例中为integer，规范为uuid)。

​
created_at
integer

上传时间。