接口说明
POST /putb64/<Fsize>/key/<EncodedKey>/mimeType/<EncodedMimeType>/crc32/<Crc32>/x:user-var/<EncodedUserVarVal>
Host: upload.qiniu.com
Authorization: UpToken <UpToken>
Content-Type: application/octet-stream <Base64EncodedFileContent>
<Fsize>
: 文件大小,必选。<EncodedKey>
: 可选,如果没有指定则:如果 uptoken.SaveKey 存在则基于 SaveKey 生产 key,否则用 hash 值作 key。<EncodedMimeType>
: 文件的 MIME 类型。可选,默认是 application/octet-stream。<Crc32>
: 文件内容的 crc32 校验值。可选,不指定则不进行校验。Host
:上传域名up.qiniu.com 用于服务端上传,upload.qiniu.com 用于客户端的上传
返回包:
200 OK {
hash: <ETag>
}
通过javascript方式上传:
javascript代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
function putb64(){
var pic = "填写你的base64后的字符串" ;
var url = "http://upload.qiniu.com/putb64/20264" ;
var xhr = new XMLHttpRequest();
xhr.onreadystatechange= function (){
if (xhr.readyState==4){
document.getElementById( "myDiv" ).innerHTML=xhr.responseText;
}
}
xhr.open( "POST" , url, true );
xhr.setRequestHeader( "Content-Type" , "application/octet-stream" );
xhr.setRequestHeader( "Authorization" , "UpToken 填写你从服务端获取的上传token" );
xhr.send(pic);
} |
注意事项:
var url = "http://upload.qiniu.com/putb64/20264";
这里的20264是你的图片的没经过base64处理的原图的字节大小。xhr.setRequestHeader("Authorization", "UpToken 填写你从服务端获取的上传token");
这里的UpToken与后面的字符串保留一个空格。后面跟上你在服务端请求的token的字符串。具体你通过什么样子的请求方式获得是客户自己要关心的事情。获取文件大小的时候,切记要通过文件流的方式获取。而不是通过图片标签然后转换后获取。
var url = "http://upload.qiniu.com/putb64/20264";
中可以扩展为以下方式:http://upload.qiniu.com/putb64/Fsize/key/EncodedKey/mimeType/EncodedMimeType/x:user-var/EncodedUserVarVal
Fsize: 文件大小,必选。支持传入 -1 表示文件大小以 http request body 为准。
EncodedKey: 可选,如果没有指定则:如果 uptoken.SaveKey 存在则基于 SaveKey 生产 key,否则用 hash 值作 key。 .
整个EncodedKey需要经过base64编码!!
- 如:
var key = uuid();
key = base64encode(key);
var url = 'http://upload.qiniu.com/putb64/-1/key/'+key具体可以参照: http://developer.qiniu.com/docs/v6/api/overview/appendix.html#urlsafe-base64
EncodedMimeType: 文件的 MIME 类型。可选,默认是 application/octet-stream。
举例:上传后并指定自定义的key:
http://upload.qiniu.com/putb64/12345/key/usxxeigng=