没有合适的资源?快使用搜索试试~ 我知道了~
首页分布式云存储API详细规范与功能更新历史
分布式云存储API规范是一份详细规定了在分布式云环境中实现云存储服务的接口标准文档。它旨在提供一套统一的接口设计,以便开发者能够高效地进行数据存储、管理以及访问。该规范主要包括以下几个核心部分: 1. 断点续传接口API设计:规范强调了如何设计支持断点续传的API,这是为了提高用户体验,特别是当网络连接中断时,用户可以从上次中断的位置继续上传或下载数据,减少数据传输的浪费。 2. CDN存储接口:CDN(内容分发网络)是云存储的一部分,规范中包含了CDN与云存储的集成接口,确保内容的快速分发和全局访问,提高了内容的可用性和性能。 3. 云存储标准接口API:这些接口涵盖了基础功能,如文件上传、下载、删除、文件信息查询等,以及高级功能,如图片处理(缩放、水印、高级图片处理)、上传凭证管理、HTTP状态响应码控制、URL安全操作(Base64编码和HMAC-SHA1签名)、通知机制、重试机制、分片上传等。 规范随着技术发展和需求变化而不断更新迭代,从0.4版本的初稿,到1.12版本添加了音视频处理接口和查询持久化处理状态的功能,反映了业界对高效、稳定、安全的云存储解决方案的持续追求。每个版本的修订都针对当时的技术问题和用户体验进行了优化,例如,上传凭证策略的修正,回调数据结构的调整,以及对错误处理和重试机制的完善。 此外,规范还提供了详细的编制和审核流程,确保了内容的专业性和一致性。通过这份规范,开发人员可以更好地理解和使用分布式云存储服务,提升应用程序的性能和可靠性。
资源详情
资源推荐
4.返回给客户端的结果
application/json
3.上传文件
(提供上传凭证)
1.获取上传凭证
(提供上传策略信息)
2.返回上传凭证
客户端
网宿云存储
5.发送通知
(application/json)
6.响应状态结果
企业WEB系统
图 4-1-3 通知上传图解
4.2 请求说明
请求方式
POST
URL
http://up.wcsapi.biz.matocloud.com:8090/file/upload
Http Header-Content-Type
multipart/form-data
Http Header-Content-Length
整个 Multipart 内容的总长度,单位:字节(Byte)
是否需要凭证
提供上传凭证
返回数据格式(Content-Type)
application/json
4.3 请求参数
参数
必填
描述
token
是
上传凭证(http-header)
-
是
文件的二进制数据流
4.4 返回结果格式
默认成功返回
Urlsafe_Base64_Encode("hash <hash string>")
字段名
必填
描述
hash
是
经过 URL 安全的 Base64 编码后的上传文件的哈希值。
默认失败返回的结果
{
"code": "<code string>",
"message": "<message string>"
}
字段名
必填
描述
code
是
上传失败状态码,参看 HTTP 响应状态码<返回码>
message
是
上传失败的提示信息
提示:由于上传结果支持自定义,具体可以参考 callBackBody 和 returnBody 返回格式描述。
HTTP 状态信息参见 HTTP 响应状态码列表
4.5 范例
命令行范例
curl -v -i -X POST -H "Expect:" -F file=@D:/8.png -F
token="6a69ab4062cb03059e4c13a0f5e662523effad49:eyJzY29wZSI6InRlc3RwdToxLnBuZyIsImRlYWRsa
W5lIjoxNDUxNDkxMjAwLCJyZXR1cm5Cb2R5IjoiaGVoZSJ9:M2ZjYzlmOWUzNGQ4NDI4ZjM5ZDk2MTlmODNkM2QyO
TM5NWI0MjA0Ng==" --url http://up.wcsapi.biz.matocloud.com:8090/file/upload
5 获取文件信息
5.1 描述
该接口用于在云存储平台上获取一个文件的信息描述,包括文件名,文件大小,文件的 ETag 信息,以 MIME 信
息表达的文件类型,文件上传时间。
5.2 请求说明
请求方式
GET
URL
http://mgr.wcsapi.biz.matocloud.com/stat/{param1}
请求头部 Authorization
需要提供管理凭证
返回数据格式(Content-Type)
application/json
{param1}生成规则:空间名+”:”+文件名,对拼接的字符串做 URL 安全的 Base64 编码(Urlsafe_Base64_Encode)。
{param1}= Urlsafe_Base64_Encode(空间名:文件名)
管理凭证参数
<path>:/stat/{param1}
5.3 请求参数
无
5.4 返回结果格式
返回成功
{
"result": "true",
"code": "200",
"name": "<fileName string>",
"message": "< message string>",
"fsize": "<FileSize int>",
"hash": "<FileETag string>",
"mimeType: "<MimeType string>",
"putTime": "<PutTime int64>"
}
字段名
必填
描述
code
是
请求返回状态码,参看 HTTP 响应状态码<返回码>
name
是
文件名
message
是
获取文件信息成功的提示信息
fsize
是
文件尺寸,单位:字节(Byte)
hash
是
文件的 ETag 信息
mimeType
是
以 MIME 信息表达的文件类型。请参见 MIME Media Types(内容
由 IANA 维护)
putTime
是
文件上传时的服务器端 Epoch 时间戳,单位:毫秒。
例如返回时间戳为 13603956734587420,对应实际时间为
2013-02-09 15:41:13
result
是
代表处理是否成功。"true"表示处理成功。
返回失败
{
"code": "<HttpCode int>",
"message": "<ErrMsg string>"
}
字段名
必填
描述
code
是
请求返回状态码,参看 HTTP 响应状态码<返回码>
message
是
获取文件信息失败的提示信息
5.5 范例
命令行范例
curl -v -H
"Authorization:bea919a5a1bc53d76a9e4340951b0b3692ff2517:ZDMzZDk1YTNjMTYxYTM0Y2MxNjk0NzA1N
jFhYmViMDcxZTBmNmI2Zg==" "http://mgr.wcsapi.biz.matocloud.com/stat/aW1hZ2U6MS5wbmc="
6 删除文件
6.1 描述
该接口提供在云存储平台上删除一个指定资源文件。
6.2 请求说明
请求方式
POST
URL
http://mgr.wcsapi.biz.matocloud.com/delete/{param1}
请求头部 Authorization
需要提供管理凭证
返回数据格式(Content-Type)
application/json
{param1}生成规则:空间名+”:”+文件名,对拼接的字符串做 URL 安全的 Base64 编码(Urlsafe_Base64_Encode)。
{param1}= Urlsafe_Base64_Encode(空间名:文件名)
管理凭证参数
<path>:/delete/{param1}
6.3 请求参数
无
6.4 返回结果格式
返回成功
{
"code": "200",
"message": "OK"
}
字段名
必填
描述
剩余86页未读,继续阅读
coolsunchen
- 粉丝: 0
- 资源: 2
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
最新资源
- AirKiss技术详解:无线传递信息与智能家居连接
- Hibernate主键生成策略详解
- 操作系统实验:位示图法管理磁盘空闲空间
- JSON详解:数据交换的主流格式
- Win7安装Ubuntu双系统详细指南
- FPGA内部结构与工作原理探索
- 信用评分模型解析:WOE、IV与ROC
- 使用LVS+Keepalived构建高可用负载均衡集群
- 微信小程序驱动餐饮与服装业创新转型:便捷管理与低成本优势
- 机器学习入门指南:从基础到进阶
- 解决Win7 IIS配置错误500.22与0x80070032
- SQL-DFS:优化HDFS小文件存储的解决方案
- Hadoop、Hbase、Spark环境部署与主机配置详解
- Kisso:加密会话Cookie实现的单点登录SSO
- OpenCV读取与拼接多幅图像教程
- QT实战:轻松生成与解析JSON数据
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功