优特云
[ { "name": "首页", "url": "http://www.utyun.com/", "target": "0", "child": [] }, { "name": "活动", "url": "http://www.utyun.com/h-col-141.html", "target": "0", "child": [] }, { "name": "产品", "url": "", "target": "1", "child": [ { "name": "U语言", "url": "http://www.utyun.com/h-col-176.html", "target": "0", "child": [] }, { "name": "U平台", "url": "http://www.utyun.com/h-col-150.html", "target": "0", "child": [] } ] }, { "name": "技术与服务", "url": "", "target": "1", "child": [ { "name": "运维服务", "url": "http://www.utyun.com/h-col-161.html", "target": "0", "child": [] }, { "name": "技术方案", "url": "http://www.utyun.com/h-col-178.html", "target": "0", "child": [] } ] }, { "name": "优特云学院", "url": "", "target": "1", "child": [ { "name": "教程", "url": "http://www.utyun.com/h-col-166.html", "target": "0", "child": [] }, { "name": "下载中心", "url": "http://www.utyun.com/h-col-170.html", "target": "0", "child": [] }, { "name": "论坛", "url": "http://www.utyun.com/h-col-169.html", "target": "0", "child": [] } ] }, { "name": "关于优特云", "url": "", "target": "1", "child": [ { "name": "企业概况", "url": "http://www.utyun.com/h-col-171.html", "target": "0", "child": [] }, { "name": "新闻动态", "url": "http://www.utyun.com/h-col-172.html", "target": "0", "child": [] }, { "name": "加入我们", "url": "http://www.utyun.com/h-col-173.html", "target": "0", "child": [] }, { "name": "团队风采", "url": "http://www.utyun.com/h-col-140.html", "target": "0", "child": [] } ] } ]

小文件(集成)
小文件-使用手册

奕河 最后一次编辑

接近 4 年前 99

组件介绍

小文件服务
引入第三方平台七牛云,提供小文件的存储服务,实现海量数据的存储和管理,对进行文件的上传、下载和管理。
swagger访问地址:

API 参考

API 列表(共6个)

序号接口名称接口描述版本
七牛云空间配置
1新增七牛云存储空间配置POST: /smallfile/qiniu/qiniuConfigV1.00
2获取七牛云存储空间配置列表  GET: /smallfile/qiniu/qiniuConfigV1.00
3删除七牛云存储空间配置  POST: /smallfile/qiniu/qiniuConfigV1.00
七牛云对象存储
4后端直传POST: /smallfile/qiniu/server_uploadV1.00
5获取前端直传授权tokenGET: /smallfile/qiniu/client_upload_keyV1.00
6后端直传获取到的私有空间对象访问路径是有时效限制的,建议访问私有对象时,均调用本接口获取最新的访问路径。GET: /smallfile/qiniu/private_image_view_urlV1.00

七牛云空间配置

新增七牛云存储空间配置

基本信息
Path:/smallfile/qiniu/qiniuConfig
Method: POST
接口描述:
该接口由基础平台为应用开通存储空间后调用
请求参数
Headers
参数名是否必须类型说明
Content-Typestring请求类型: application/json
Body
参数名是否必须类型说明
appKeystring应用key
appNamestring应用名称
accessKeystring七牛云账户ak
secretKeystring七牛云账户sk
bucketTypestring存储空间类型:0=公有,1=私有  
bucketNamestring存储空间名称  
bucketHoststring存储空间host路径
返回参数
参数名类型说明
idlong主键
appKeystring应用key
appNamestring应用名称
accessKeystring七牛云账户ak
secretKeystring七牛云账户sk
bucketTypestring存储空间类型:0=公有,1=私有
bucketNamestring存储空间名称
bucketHoststring存储空间host路径

获取七牛云存储空间配置列表

基本信息
Path:/smallfile/qiniu/qiniuConfig
Method: GET
接口描述:
请求参数
返回参数
[ { "id": 1, "appKey": "kitchen", "appName": "智能厨房", "accessKey": "C9mMCiPrmzQ5LTLIiYaAy8WlJMpPINCeD2wxOUSi", "secretKey": "LNv3l-Pt-Z1KXLUoR_mQuoCSsXUhy-aTybBLLzZz", "bucketType": "0", "bucketName": "kitchen-public", "bucketHost": "http://qiniu-pub.utcook.com" }, { "id": 3, "appKey": "kitchen", "appName": "智能厨房", "accessKey": "C9mMCiPrmzQ5LTLIiYaAy8WlJMpPINCeD2wxOUSi", "secretKey": "LNv3l-Pt-Z1KXLUoR_mQuoCSsXUhy-aTybBLLzZz", "bucketType": "1", "bucketName": "kitchen-private", "bucketHost": "http://qiniu-prv.utcook.com" } ]

删除七牛云存储空间配置

基本信息
Path:/smallfile/qiniu/qiniuConfig
Method: DELETE
接口描述:
请求参数
Headers
参数名是否必须类型说明
Content-Typestring请求类型: application/json
Body
参数名是否必须类型说明
idlong配置主键
返回参数

七牛云对象存储

后端直传

基本信息
Path:/smallfile/qiniu/server_upload
Method: POST
接口描述:
请求参数
Headers
参数名是否必须类型说明
Content-Typestring请求类型: x-www-form-urlencoded
Body
请求参数
参数名类型说明
hoststring存储空间host
hashstring存储对象hash值
keystring对象key(对象上传时若未指定名字,该值即为hash值)

获取前端直传授权token

基本信息
Path:/smallfile/qiniu/client_upload_key
Method: GET
接口描述:
请求参数
Headers
参数名是否必须类型说明
Content-Typestring请求类型: x-www-form-urlencoded
Query
参数名是否必须类型说明
fileNameString可选,指定时,同名对象会被最近一次上传覆盖
appKeyString应用key
isPrivateBucketboolean是否使用私有空间(不指定默认使用公共空间)
返回参数
参数名类型说明
hoststring存储空间host
tokenstring授权客户端上传token

后端直传

基本信息
Path:/smallfile/qiniu/client_upload_key
Method: GET
接口描述:
获取到的私有空间对象访问路径是有时效限制的,建议访问私有对象时,均调用本接口获取最新的访问路径。
请求参数
Headers
参数名是否必须类型说明
Content-Typestring请求类型: x-www-form-urlencoded
Query
参数名是否必须类型说明
appKeyString应用key
objectKeyString私有空间对象key
expireslong有效时长,单位秒,默认3600s
返回参数
参数名类型说明
privateImgViewUrlstring私有空间对象访问路径

七牛云图片处理

示例
  1. 图片原图访问路径:http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn
  2. 若要按200*200限定宽高等比缩放,则使用模式:imageView2/2/w/200/h/200/q/75
  3. 图片缩略图访问方式: http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn?imageView2/2/w/200/h/200/q/75
示例
  1. 图片原图访问路径:http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn
  2. 若要执行按20%等比缩放图片,则使用模式:imageMogr2/thumbnail/!20p
  3. 图片缩略图访问方式: http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn?imageMogr2/thumbnail/!20p
示例
  1. 图片原图访问路径:http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn
  2. 水印图片原路径:http://qiniu-pub.utcook.com/utcookLogo.png
  3. 水印图片原路径base64编码:aHR0cDovL3Fpbml1LXB1Yi51dGNvb2suY29tL3V0Y29va0xvZ28ucG5n
  4. 图片水印效果: http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn
示例
  1. 图片原图访问路径:http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn
  2. 获取图片信息路径:http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn?imageInfo
  3. 响应结果:
{ "size": 435194, "format": "jpeg", "width": 1280, "height": 1920, "colorModel": "ycbcr" }
示例
  1. 图片原图访问路径:http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn
  2. 获取图片exif路径:http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn?exif
  3. 响应结果:
{ "ColorSpace": { "val": "sRGB", "type": 3 }, "Copyright": { "val": "CAOHONGJUN (Photographer) - (Editor)", "type": 2 }, "ExifVersion": { "val": "Unknown Exif Version", "type": 7 }, "FlashPixVersion": { "val": "FlashPix Version 1.0", "type": 7 }, "ResolutionUnit": { "val": "Inch", "type": 3 }, "XResolution": { "val": "300", "type": 5 }, "YResolution": { "val": "300", "type": 5 } }
示例
  1. 图片原图访问路径:http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn
  2. 获取图片平均色调路径:http://qiniu-pub.utcook.com/FmRN-tWeF127TH5Q_cs4Lsr62NGn?imageAve
  3. 响应结果:
{"RGB": "0xa85f67"}

产品版本

日期修改描述作者
2019-7-28初版发布平台产品部

更新日志

日期修改描述
2019-7-28发布小文件服务,创建小文件服务的用户使用手册

优特云