S3配置及使用
首先,我们学习如何配置S3,这里以腾讯云为例。
S3配置
S3配置主要有:
名称 | tengxunyun | 文件存储的名称 |
服务地址 | cos.ap-nanjing.myqcloud.com | S3服务访问地址 |
APP ID | AKID0zoR4VmsnWFsIVVIsFPM6htvlPo0yw43 | |
APP Secret | ******************************** | 可以用环境变量存储 |
区域 | ap-nanjing | |
桶名称 | test-1314985928 | bucket名称 |
开启SSL | 是 | 开启后用HTTPS访问 |
使用步骤:
在文件存储面板中点击“+”,进入S3新建页
前往各S3 Provider的文档页,查看如何获取参数(前往查看教程)
输入供应商名称及其他参数
点击测试,若测试通过,点击保存,进入详情页
S3使用
配置S3供应商后,飞布将注册上传路由,路由规则为:
上传文件
用户可通过该路由,上传文件至指定目录,目录由directory字段指定。
使用该路由上传文件时,必须要登录,即携带cookie 或 access_token!
上传文件后,返回文件的相对地址,为:
返回结果是一个对象数组,对象只有一个字段 key
,其命名规则:目录+文件的hash值(xxHash是一种非常快速的哈希算法)
访问文件
有两种方式访问上述文件:
标准方式:https://桶名称.服务地址/fileKey,例如:https://test-1314985928.cos.ap-nanjing.myqcloud.com/aaaa/logotest.png
其他方式:https://服务地址/桶名称/fileKey,例如:https://cos.ap-nanjing.myqcloud.com/test-1314985928/aaaa/logotest.png
对于私有桶,还需要追加临时签名才能访问:
查看临时签名的生成方式,请前往 文件上传钩子
客户端使用
使用文件上传,只需要按照文件上传的接口规范,构建一个POST文件上传请求,即可将文件上传至S3 bucket中。这适用于任何可以使用HTTP请求发送FormData的环境。
快速测试
使用预览页可以快速测试文件上传,具体步骤如下。
点击顶部菜单栏的“
”,前往API预览页
在左侧FileUpload中选择上传路由,设置上传目录directory的值,选择文件,点击”TRY“,返回数组,fileKey
若上传时返回401错误,请登录后重试
在预览页顶部,选择OIDC供应商,点击前往登录
拼接目录,访问文件
SDK使用
除了自行按照规范构建上传接口,还可以用Fireboom生成的SDK上传文件,详情见各客户端SDK文档。
微信小程序:文件上传
最后更新于