ATKONBASE

外观

统一预览签发：自动分流源文件 / PREVIEW 衍生物 / 不可预览​

POST
/v1/versions/preview-url

客户端仅传 versionId，服务端内部完成可预览性判断与源 / 衍生物分流：previewable=true —— url 为 inline 预览地址，previewSource 标注来源（SOURCE 源文件 / RENDITION 预览衍生物），mode 与 /v1/versions/signed-url 同口径（presigned / fallback）；previewable=false —— 源与 PREVIEW 衍生物均不可内联，不含 url，downloadHint 引导改走下载，此为可预测的正常出口、无签发副作用。端点只做 inline 预览、不接受下载模式；下载仍走 /v1/versions/signed-url?mode=download。可内联类型为 image/* / application/pdf / text/plain / audio/* / video/*，image/svg+xml 除外。访问门控走源版本下载授权：无权限 / 版本不存在 / 版本已回收或归档返回相应错误码，而非 previewable=false。

参数​

请求头参数

Authorization*

访问令牌以 Bearer 方案在 HTTP Authorization 请求头携带。请在此填入完整值（含 Bearer 前缀），例如：Bearer <accessToken>。

类型
string
必填
示例"Bearer <accessToken>"
X-Atk-User-Token

强通道（可选）：以某已签发的 atkonbase 用户会话 token 调用，ACL 解析与操作归属走该用户。与弱通道 X-Atk-Act-As-Source(-Id) 互斥——同时携带返回业务码 101008。两个 SDK 均由 client 侧拦截器统一注入（actAsToken()），此处仅为门户演练暴露。

类型
string
X-Atk-Act-As-Source

弱通道（可选）：外部身份来源标识，须与 X-Atk-Act-As-Source-Id 成对携带，缺一返回业务码 101009。仅当该 Client 的 act_as_user_allowed=true 时生效，否则静默降级为 APP_ONLY；与强通道互斥。两个 SDK 均由 client 侧拦截器统一注入（actAsSource()），此处仅为门户演练暴露。

类型
string
X-Atk-Act-As-Source-Id

弱通道（可选）：外部身份在其来源系统内的 ID，须与 X-Atk-Act-As-Source 成对携带，缺一返回业务码 101009。

类型
string

请求体​

application/json
JSON
{
  
"versionId": "string",
  
"expiresInSec": 0
}

响应​

OK

*/*
JSON
{
  
"code": 0,
  
"data": {
  
  
"versionId": "string",
  
  
"previewable": true,
  
  
"previewSource": "string",
  
  
"mimeType": "string",
  
  
"url": "string",
  
  
"mode": "string",
  
  
"expiresAt": "string",
  
  
"downloadHint": "string"
  
},
  
"ts": 0,
  
"rid": "string",
  
"msg": "string",
  
"success": true
}

试验场​

服务器
请求头
主体

示例​

技术支持 VitePress OpenAPI