又拍云存储API操作文档v1

=================================又拍云存储API操作文档v1.2=================================又拍云存储，用户可根据需要使用FTP或API进行操作。建议使用我们提供的SDK进行API开发，SDK下载页面：帐号信息-----------------------------以下为示例使用的帐号信息，使用时请用实际的帐号信息代替。访问域名:(使用用户绑定的独立域名)Api接口地址:(电信)(联通网通)(移动铁通)(自动判断）API接口同时支持HTTPS操作Bucketname:demobucket（空间名称）Username:demouser（操作员用户名,非管理帐号）Userpass:demopass（操作员密码）---------------------------------------------------------------------一、认证方式:1、HTTPBasicAuth验证采用标准httpbasicauth验证方式。请求方法:GET/demobucket/HTTP/1.1Host:v0.api.upyun.comAuthorization:BasicYWFhOmFw代码示例(PHP):?php$process=curl_init(');curl_setopt($process,CURLOPT_USERPWD,demouser:demopass);curl_setopt($process,CURLOPT_HEADER,0);curl_setopt($process,CURLOPT_TIMEOUT,30);curl_setopt($process,CURLOPT_RETURNTRANSFER,1);curl_setopt($process,CURLOPT_FOLLOWLOCATION,1);var_dump(curl_exec($process));var_dump(curl_getinfo($process,CURLINFO_HTTP_CODE));curl_close($process);?2、签名验证1)签名格式:Authorization:UpYundemouser:signature其中:UpYun为固定字符，与username之间以空格间隔demouser空间的操作用户帐号signature签名内容2)签名内容生成md5(METHOD&URI&DATE&CONTENT_LENGTH&md5(PASSWORD))各组成内容介绍:&字符串连接符METHOD本次请求的方式URIURI,必须http协议标准（中文文件名或目录需进行rawurlencode编码RFC1738）DATE日期格式:Wed,24Aug201109:13:05GMT(RFC1123)格式请注意服务器时间必须跟世界时间一致，否则签名失败，并返回Dateoffseterror错误。CONTENT_LENGTHcontent长度，需与请求header中Content-Length一致（GET方法，长度为0)md5(PASSWORD):帐号密码进行md5加密请求方法:GET/demobucket/HTTP/1.1Host:v0.api.upyun.comAuthorization:UpYundemouser:62c428533830d84fd8bc77bf402512fcDate:Wed,24Aug201107:33:47GMT代码示例(PHP):?php$process=curl_init(');$date=gmdate('D,dMYH:i:s\G\M\T');$sign=md5('GET&/demobucket/&'.$date.'&0&'.md5(userpass));curl_setopt($process,CURLOPT_HTTPHEADER,array('Expect:',Authorization:UpYundemouser:.$sign));curl_setopt($process,CURLOPT_HEADER,0);curl_setopt($process,CURLOPT_TIMEOUT,30);curl_setopt($process,CURLOPT_RETURNTRANSFER,1);curl_setopt($process,CURLOPT_FOLLOWLOCATION,1);var_dump(curl_exec($process));var_dump(curl_getinfo($process,CURLINFO_HTTP_CODE));curl_close($process);?二、HTTPREST接口支持的API操作方法上传文件（2012-02加入自动创建父级目录功能）下载文件删除文件创建目录（2012-02加入自动创建父级目录功能）删除目录获取目录文件列表获取空间使用情况获取文件信息（2012-02新增）上传文件:HTTPPUT上传文件操作。请求方法:PUT/demobucket/a.txtHTTP/1.1Authorization:BasicYWFhOmFwHost:v0.api.upyun.comContent-Type:image/jpg///可选///设置待上传文件的Content-Type类型（如不设置，又拍云存储将使用存储的文件名中扩展名进行自动设置）Content-MD5:cf3e1ce231e15a9e3a42ff688074a628///可选///设置待上传文件的Content-MD5值（如又拍云服务端收到的文件MD5值与用户设置的不一致，将回报406NotAcceptable错误）Content-Secret:bac///可选///设置待上传文件的访问密钥（注意：仅支持图片空间！，设置密钥后，无法根据原文件URL直接访问，///需带URL后面加上（缩略图间隔标志符+密钥）进行访问）///如缩略图间隔标志符为!，密钥为bac，上传文件路径为/folder/test.jpg，///那么该图片的对外访问地址为：http://空间域名/folder/test.jpg!bacContent-Length:48...文件内容...返回格式:状态HTTP200OK表示文件上传成功，如遇到错误请具体参考返回的BODY信息。对于图片空间上传图片成功后，还在Header包含图片信息如下：x-upyun-width:(int)图片宽度x-upyun-height:(int)图片高度x-upyun-frames:(int)图片帧数x-upyun-file-type:图片文件类型代码示例(PHP):?php$data='demodata';$process=curl_init(');curl_setopt($process,CURLOPT_POST,1);curl_setopt($process,CURLOPT_POSTFIELDS,$data);curl_setopt($process,CURLOPT_USERPWD,demouser:demopass);curl_setopt($process,CURLOPT_HTTPHEADER,array('Expect:'));///如果需要自动创建父级目录功能（仅限10级）///curl_setopt($process,CURLOPT_HTTPHEADER,array('Expect:',Mkdir:true));curl_setopt($process,CURLOPT_HEADER,0);curl_setopt($process,CURLOPT_TIMEOUT,60);curl_setopt($process,CURLOPT_RETURNTRANSFER,1);curl_setopt($process,CURLOPT_FOLLOWLOCATION,1);curl_setopt($process,CURLOPT_HEADER,1);///获取header（如需获取图片上传成功后的信息)var_dump(curl_exec($process));var_dump(curl_getinfo($process,CURLINFO_HTTP_CODE));curl_close($process);?*注意:图片空间无法上传普通文件，否则报403错误。下载文件:HTTPGET读取文件操作。请求方法:GET/demobucket/a.txtHTTP/1.1Authorization:BasicYWFhOmFwHost:v0.api.upyun.com代码示例(PHP):?php$process=curl_init(');curl_setopt($process,CURLOPT_USERPWD,demouser:demopass);curl_setopt($process,CURLOPT_HEADER,0);curl_setopt($process,CURLOPT_TIMEOUT,30);curl_setopt($process,CURLOPT_RETURNTRANSFER,1);curl_setopt($process,CURLOPT_FOLLOWLOCATION,1);var_dump(curl_exec($process));var_dump(curl_getinfo($process,CURLINFO_HTTP_CODE));curl_close($process);?删除文件:删除文件操作。请求方法:DELETE/demobucket/a.txtHTTP/1.1Authorization:BasicYWFhOmFwHost:v0.api.upyun.com代码示例(PHP):?php$process=curl_init(');curl_setopt($process,CURLOPT_CUSTOMREQUEST,'DELETE');curl_setopt($process,CURLOPT_USERPWD,demouser:demopass);curl_setopt($process,CURLOPT_HEADER,0);curl_setopt($process,CURLOPT_TIMEOUT,30);curl_setopt($process,CURLOPT_RETURNTRANSFER,1);curl_setopt($process,