云存储接口文档


文件存储REST API允许任何语言终端通过发起HTTPS请求来操作数据存储模块。

当前版本

1.0

服务地址

API地址

  http://file.369cloud.com

说明

冒号(:)引导的为参数。

目录

文件上传

  • 上传文件到 369Cloud 通过 POST 请求。
  • 上传最大文件大小有 50 M 的限制。

post

/file/uploading

Headers

命令格式(模拟form上传文件)

curl -X POST \
-H "X-369Cloud-App-Id: {{appid}}" \
-H "X-369Cloud-App-Key: {{appkey}}" \
-F "fileName(含后缀)=@filePath" http://file.369cloud.com/file/uploading

示例: 模拟form上传文件

curl -X POST \
-H "X-369Cloud-App-Id: 680206416577036288" \
-H "X-369Cloud-App-Key: b7703633684f400bbb1dd8f117046917" \
-F "test.mp3=@D:\workspace\xhrd-storage\public\MP3\test.mp3" http://file.369cloud.com/file/uploading

web示例

<!-- 提示:示例中使用的是WebUploader http://fex.baidu.com/webuploader/ -->

<!-- css -->
<link rel="stylesheet" type="text/css" href="./css/webuploader.css" />

<!-- script -->
<script type="text/javascript" src="jquery-1.10.2.min.js"></script>
<script type="text/javascript" src="webuploader.min.js"></script>

<!-- html -->
<div id="filePicker">上传</div>

<script type="text/javascript">
    var url = 'http://file.369cloud.com/file/uploading';
    (function( $ ){
       $(function () {
           var uploader = WebUploader.create({
               pick: "#filePicker",
               server: url,
               resize: false,
               auto: true
           });
           uploader.on("fileQueued", function (file) {
               uploader.option('formData', {
                   filename: file.name,
                   type: file.type
               });
           });
           //文件上传成功
           uploader.on('uploadSuccess', function (file, res) {
               console.log('文件上传成功: ', res)
           });
           //文件上传失败
           uploader.on('uploadError', function (file, reason) {
               console.log('文件上传失败: ', file, reason)
           });
           //上传完成,不管成功失败
           uploader.on('uploadComplete', function (file) {
               uploader.removeFile(file);
           });
           uploader.on('uploadBeforeSend', function (block, data, headers) {
               headers["X-369Cloud-App-Id"] = "702781879195271168";
               headers["X-369Cloud-App-Key"] = "0fe730589e9642828de414a36ac381ad";
           });
           //上传中
           uploader.on('uploadProgress',function(file, percentage){
               console.log('上传中: ', percentage)
           });
       });
   })(jQuery);
</script>

Success-Response

{
    status:状态码 0:失败, 1:成功
    code:错误码
    err:错误信息
    data:数据
}

成功响应示例

{
    "status":1,
    "code":"",
    "err":"",
    "data":{
        "result":"success",
        "url":"http://cloud.pan.369cloud.com/cloud/compile/android/4c7c0b9759ed750605518f007376080b.mp3"
    }
}

Error-Response

{
    status:状态码 0:失败, 1:成功
    code:错误码
    err:错误信息
}

错误码对照表

错误响应示例

{
    "status":0,
    "code":"26002",
    "err":"上传文件失败",
    "data":null
}