返回能力总览
申请接入
文件存储与文件访问
统一文件中枢:上传、下载、一次性签名链接
能力服务(RS)提供文件存储能力:按客户账号隔离命名空间、sha256 去重、一次性签名下载链接,可安全地把站内文件分享给外部。
能力说明与典型场景
- sha256 内容去重,重复上传不占额外空间
- 一次性签名链接:限定次数与有效期,业务系统后端可控外发
- 按客户令牌账号隔离命名空间,互不可见
- 能力声明见 /.well-known/rs-metadata
业务系统上传/管理文件,或将文件安全地开放给客户/访客下载。
开放接口
| 接口 | 方法 | 路径 | 说明 |
|---|---|---|---|
| 上传 | POST | /api/files | multipart 直传文件(字段 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"完整鉴权链路(平台令牌 → 直连能力 → 按调用计费)见 接入文档。
对「文件存储」感兴趣?
提交商务申请,交付团队将为您提供报价与接入方案。