接口参考
后台·上传
会话认证的后台上传,与数据面同一管道
POST
与 POST /api/upload 同一管道与防护闸,归属为会话用户,来源 Token 记空。
sessioncookie
imgyoung_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 档位;缺省用运营配置的全局默认
Value in
"strip""passthrough"ttl?string有效期秒数(0 到 3153600000 的整数)或 never 表示永久;缺省按「用户默认 > 全局默认」回退
已入库
application/json- response
id*string图片短 ID
url*string图片绝对访问地址;配置了 base_url 用配置,否则按请求推导
Format
uricurl -X POST 'http://localhost:8721/api/admin/upload' \ -H 'X-CSRF-Token: string' \ -F 'file=string'{ "id": "string", "url": "http://example.com"}POST
与 POST /api/upload/url 同一管道,归属为会话用户。
sessioncookie
imgyoung_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 的公网地址
Format
urifile_name?string覆盖由地址末段推断的文件名
exif_policy?string本次 EXIF 档位;缺省用全局默认
Value in
"strip""passthrough"ttl?|有效期秒数(数字或数字字符串)或 never;缺省按「用户默认 > 全局默认」回退
已入库
application/json- response
id*string图片短 ID
url*string图片绝对访问地址;配置了 base_url 用配置,否则按请求推导
Format
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"}