返回能力总览
申请接入
文件存储与文件访问
统一文件中枢：上传、下载、一次性签名链接
内置文件存储能力：按应用隔离命名空间、sha256 去重、一次性签名下载链接，可安全地把站内文件分享给外部。
能力说明与典型场景
- sha256 内容去重，重复上传不占额外空间
- 一次性签名链接：限定次数与有效期，业务系统后端可控外发
- 按应用隔离命名空间，互不可见
- 计费口径声明见代码能力注册表（各能力模块 catalog.ts）
业务系统上传/管理文件，或将文件安全地开放给客户/访客下载。
开放接口
| 接口 | 方法 | 路径 | 说明 |
|---|---|---|---|
| 上传 | 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.site/api/files \
-H "Authorization: Bearer ${TMXK_APP_TOKEN}" \
-F "file=@report.docx"完整鉴权链路（平台令牌 → 直连能力 → 按调用计费）见 接入文档。
对「文件存储」感兴趣？
提交商务申请，交付团队将为您提供报价与接入方案。