返回能力总览

文件存储与文件访问

统一文件中枢:上传、下载、一次性签名链接

公网能力服务本地二进制能力包

能力服务(RS)提供文件存储能力:按客户账号隔离命名空间、sha256 去重、一次性签名下载链接,可安全地把站内文件分享给外部。

能力说明与典型场景

  • sha256 内容去重,重复上传不占额外空间
  • 一次性签名链接:限定次数与有效期,业务系统后端可控外发
  • 按客户令牌账号隔离命名空间,互不可见
  • 能力声明见 /.well-known/rs-metadata

业务系统上传/管理文件,或将文件安全地开放给客户/访客下载。

开放接口

接口方法路径说明
上传POST/api/filesmultipart 直传文件(字段 file),按账号命名空间隔离
下载 / 删除GET/DELETE/api/files/:fileId校验客户令牌后下载或删除
签名链接POST/api/files/:fileId/link生成一次性临时下载链接(/l/:token?sig=),可发给任意访客
列表 / 元数据GET/api/files?limit= · /api/files/:fileId/stat文件清单与状态

计费建议

按存储量与下载流量计费;本地二进制能力包可按存储规模购买。

具体价格、额度、最低消费与服务等级以价格表或专项订单为准;公网能力失败请求是否计费见订单条款。

接入示例

携带平台客户令牌调用文件服务(令牌在门户「令牌」页创建)
curl -s -X POST https://tmxk-files.cspy.site/api/files \
  -H "Authorization: Bearer ${TMXK_SITE_PLATFORM_TOKEN}" \
  -F "file=@report.docx"

完整鉴权链路(平台令牌 → 直连能力 → 按调用计费)见 接入文档

对「文件存储」感兴趣?

提交商务申请,交付团队将为您提供报价与接入方案。

申请接入