public API

API 参考/public

public API

public 分类下共有 32 个接口。接口详情、参数、请求体与响应均从项目 OpenAPI 规格自动生成。

GET/healthz健康检查↗GET/openapi.yamlOpenAPI 规范文档↗GET/docsSwagger UI 接口文档页面↗GET/api/v1/system-configs公开系统配置列表（如默认容量、站点信息等）↗GET/api/v1/system-configs/media-base媒体基础 URL（CDN 地址或空，前端拼接媒体链接）↗GET/api/v1/plans在售套餐列表↗GET/api/v1/payment/methods可用支付方式状态↗POST/api/v1/auth/register邮箱注册（注册后自动授予默认容量）↗POST/api/v1/auth/login密码登录（命中 MFA 时返回 202 mfa_required）↗POST/api/v1/auth/refresh刷新令牌↗POST/api/v1/auth/mfa/verify登录 MFA 验证（TOTP 验证码换取令牌）↗GET/api/v1/auth/oauth/github发起 GitHub OAuth 登录（302 跳转）↗GET/api/v1/auth/oauth/github/callbackGitHub OAuth 回调↗GET/api/v1/auth/oauth/google发起 Google OAuth 登录（302 跳转）↗GET/api/v1/auth/oauth/google/callbackGoogle OAuth 回调↗GET/api/v1/auth/oauth/statusOAuth 登录状态（当前是否处于 OAuth 流程）↗GET/api/v1/auth/methods启用的认证方式列表（密码/邮箱验证码/OAuth 提供商）↗POST/api/v1/auth/oauth/mfa/verifyOAuth 登录后的 MFA 验证↗POST/api/v1/auth/phone-code/send发送手机号验证码（需启用手机号登录并配置短信服务）↗POST/api/v1/auth/login/phone-code手机号验证码登录或注册；新号码可绑定邮箱账号或创建账号↗POST/api/v1/auth/phone-bind/email-code/send发送手机号绑定用邮箱验证码↗POST/api/v1/auth/email-code/send发送登录邮箱验证码（每 IP 限频）↗POST/api/v1/auth/email-code/verify校验邮箱验证码（密码重置流程使用，不创建会话）↗POST/api/v1/auth/login/email-code邮箱验证码登录（未注册用户自动注册）↗POST/api/v1/auth/email-code/send-password发送密码重置邮箱验证码↗POST/api/v1/auth/password/forgot忘记密码（发送重置验证码）↗POST/api/v1/auth/password/reset重置密码（需验证码）↗GET/api/v1/shares/{token}通过 token 解析公开分享（有密码时仅返回元信息）↗POST/api/v1/shares/{token}/verify校验分享密码（成功后返回资产与签名媒体 URL）↗GET/api/v1/shares/{token}/media分享媒体流（需 URL 携带 expire+sig 签名，支持 Range 请求）↗GET/media/{objectKey}公开媒体对象（存储代理：OSS 302 到 CDN，本地文件流式返回；非资产回退静态文件）↗HEAD/media/{objectKey}媒体对象 HEAD（同 GET）↗