文件服务

File Service 用于在 OpenEdge 网关后提供文件上传、读取、下载和分享能力。

适用场景

• 临时文件分发。
• 公开下载链接。
• 用户级文件元数据。
• 带 API Key 和计费保护的文件操作。

API 路由

认证文件操作统一挂载在：

/v1/apps/file/*

公开下载和分享路由：

/v1/apps/file/download/*
/v1/apps/file/share/*

网关会在转发到文件服务 Worker 前完成 API Key 校验和用量记录。

服务配置

在控制台创建文件服务实例：

{
  "service_id": "file",
  "alias": "default",
  "config": {
    "root_folder": "my-bucket",
    "public_access": true
  },
  "status": "active"
}

root_folder 用于隔离存储路径。public_access 控制是否开启公开读取类能力。

鉴权

认证操作使用 API Key：

X-API-Key: sk_xxx

建议 scope：

file:read
file:write

计费

文件服务可按上传、读取或存储策略计费。商业版本建议对可计费操作写入交易流水，并和用户余额体系保持一致。