获取 presigned 上传地址 / 头像代理

GET

/api/v2/upload

上传模块的只读/代理入口，按 action 或 type 分发：action=avatar 公开代理返回指定用户的头像（userId 必填；无自定义头像时返回内置默认头像，图片流或 302 跳转 CDN）；type=presign 请求 presigned 上传地址（需 ADMIN_SECRET 或管理员/reviewer 权限），返回 { url, key, publicUrl } 供客户端直传。上传文件本体请使用 POST /api/v2/upload（服务端不提供 presigned URL 的直接上传场景，客户端直接 POST 本接口）。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.xhsr.org.cn/api/v2/upload?type=&action=&filename=&contentType=' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200

application/json

成功返回 presigned URL 信息

Bodyapplication/json

示例

{
    "url": "string",
    "key": "string",
    "publicUrl": "string"
}

🟠400

🟠401

🟠403

🔴500

修改于 2026-10-07 10:19:10

删除内容

文件上传