Admin · Upload
Session-authenticated uploads through the same pipeline as the data plane
与 POST /api/upload 同一管道与防护闸，归属为会话用户，来源 Token 记空。
sessionimgyoung_session<token>登录下发的会话 cookie；状态变更请求须另以 X-CSRF-Token 头回传会话绑定的 CSRF 令牌。
X-CSRF-Token*string登录或 GET /api/admin/me 响应里的 csrf_token；缺失或不匹配返回 403
Idempotency-Key?string客户端幂等键；保留期（运营配置 idempotency_key_ttl_hours）内同一用户同一键的重试返回同一张图
multipart/form-data- body
file*string图片文件；文件名作元数据展示
exif_policy?string本次 EXIF 档位；缺省用运营配置的全局默认
"strip""passthrough"ttl?string有效期秒数（0 到 3153600000 的整数）或 never 表示永久；缺省按「用户默认 > 全局默认」回退
已入库
application/json- response
id*string图片短 ID
url*string图片绝对访问地址；配置了 base_url 用配置，否则按请求推导
uricurl -X POST 'http://localhost:8721/api/admin/upload' \ -H 'X-CSRF-Token: string' \ -F 'file=string'{ "id": "string", "url": "http://example.com"}与 POST /api/upload/url 同一管道，归属为会话用户。
sessionimgyoung_session<token>登录下发的会话 cookie；状态变更请求须另以 X-CSRF-Token 头回传会话绑定的 CSRF 令牌。
X-CSRF-Token*string登录或 GET /api/admin/me 响应里的 csrf_token；缺失或不匹配返回 403
Idempotency-Key?string客户端幂等键；保留期（运营配置 idempotency_key_ttl_hours）内同一用户同一键的重试返回同一张图
application/json- body
url*string待转存的图片地址，仅 http / https 的公网地址
urifile_name?string覆盖由地址末段推断的文件名
exif_policy?string本次 EXIF 档位；缺省用全局默认
"strip""passthrough"ttl?|有效期秒数（数字或数字字符串）或 never；缺省按「用户默认 > 全局默认」回退
已入库
application/json- response
id*string图片短 ID
url*string图片绝对访问地址；配置了 base_url 用配置，否则按请求推导
uricurl -X POST 'http://localhost:8721/api/admin/upload/url' \ -H 'X-CSRF-Token: string' \ -H 'Content-Type: application/json' \ -d '{ "url": "http://example.com"}'{ "id": "string", "url": "http://example.com"}