上传流程说明：

DVR上传存储接口，主要包括4部分（即4个接口）。
1）上传Part文件接口（上传分片文件的接口，参数说明参照4-1）。
2）Part文件查询接口（主要是查询是否上传成功，参数说明参照4-2）。
3）上传完成接口（该接口表示所有的Part文件都已上传完成，参数说明参照4-3）。
4）中断上传接口（该接口表示中止本次上传过程，所有已上传的Part文件也会被删除，参数说明参照4-4）。
其中上传Part文件接口和上传完成接口必须调用，而Part文件查询接口可以不用调用。

名词解释：

1、fileName是指上传文件对应的文件名，需要符合文件的命名规则，否则也会造成上传失败。
2、Part是指分片文件内容，因为上传大文件必须分片，所以Part指的是大文件的分片内容。
3、PartNum是指分片对应的编号，每个文件的分片编号必须是唯一的，同时编号必须从小到大顺序依次累加。建议使用连续编号，因为该编号的使用范围是1~1000，在不这个范围内的编号都会造成上传失败。
4、只允许以下文件格式进行上传：
  1）avi，f4v，mpg，mp4，flv，wmv，mov，3gp
  2）rmvb，rm，mkv，asf，ts，mts，dat，vob，mp3，wav，m4v，webm

1．接口地址：

上传Part文件接口：http://upload.dvr.aodianyun.com/v2/DVR.UploadPart

Part文件查询接口：http://upload.dvr.aodianyun.com/v2/DVR.UploadQuery

上传完成接口：http://upload.dvr.aodianyun.com/v2/DVR.UploadComplete

中断上传接口：http://upload.dvr.aodianyun.com/v2/DVR.AbortUpload

2．HTTP请求方式：

POST

3．请求类型：

Content-Type: application/x-www-form-urlencoded

4-1．上传Part文件接口，请求参数说明（JSON格式）：

access_id：安全校验ID，值为字符串。必选
示例：”access_id”:”123456789”

 

access_key：安全校验码，值为字符串。必选
示例：”access_key”:”ABCDEFG”

fileName：上传文件名。必选
示例：”test.flv”

part：上传文件的内容，POST之前需要url_encode和base64_encode处理，part的大小必须小于10MB。必选
示例：urlencode(base64_encode(”abcd”))

partNum：上传文件的分片编号，不可重复范围是1~1000如果超出这个范围，将上传失败。必选
示例：1 2 3...

4-2．Part文件查询接口，请求参数说明（JSON格式）：

access_id：安全校验ID，值为字符串。必选
示例：”access_id”:”123456789”

 

access_key：安全校验码，值为字符串。必选
示例：”access_key”:”ABCDEFG”

fileName：上传文件名。必选
示例：”test.flv”

partNum：上传文件的分片编号，不可重复范围是1~1000如果超出这个范围，将上传失败。必选
示例：1 2 3...

4-3．上传完成接口，请求参数说明（JSON格式）：

access_id：安全校验ID，值为字符串。必选
示例：”access_id”:”123456789”

 

access_key：安全校验码，值为字符串。必选
示例：”access_key”:”ABCDEFG”

fileName：上传文件名。必选
示例：”test.flv”

4-4．中断上传接口，请求参数说明（JSON格式）：

access_id：安全校验ID，值为字符串。必选
示例：”access_id”:”123456789”

 

access_key：安全校验码，值为字符串。必选
示例：”access_key”:”ABCDEFG”

fileName：上传文件名。必选
示例：”test.flv”

4-5．请求示例：

curl -X POST \
http://upload.dvr.aodianyun.com/v2/DVR.UploadPart \
-H "Content-Type: application/x-www-form-urlencoded" \
-d '{"access_id":"123456","access_key":"ABCDEFG","fileName":"test.flv",
"part":urlencode(base64_encode(abcd)),"partNum":1}'

5-1．返回结果（JSON格式）：

Flag：操作处理结果状态码
示例：”Flag”:100。提示：Flag=100为成功，失败为非100，失败内容在FlagString中体现。

 

FlagString：操作处理结果状态说明
示例：“FlagString”：“上传处理成功”

5-2．返回参考：

{
  "Flag": 100,
  "FlagString": "上传处理成功",
  "fileName": "test.flv",
  "location": "http://*.aodianyun.com/*/test.flv"
}

6．开发DEOM参考：

1、PHP开发DEMO参考  使用PHP语言开发进行大文件上传的DEMO。
2、Python开发DEMO参考  使用Python语言开发进行大文件上传的DEMO。
3、Plupload开发示例  Plupload是一个开源的大文件上传控件，该示例已集成PHP开发内容。

 

<<返回