云相册的API开发接口CreatePhoto怎么使用-问答-阿里云开发者社区-阿里云

开发者社区> 问答> 正文

云相册的API开发接口CreatePhoto怎么使用

云栖大讲堂 2017-10-27 10:05:29 1355


描述


提交事务以完成上传照片。
  1. 请在使用该接口前确认已完全理解了上传流程中的内容。
  2. 调用该接口前需要开启事务,请参考CreateTransaction接口。


请求参数

参数名类型是否必须说明
ActionStringCreatePhoto
FileIdString开启上传事务时获取到的文件ID
PhotoTitleString照片的名称
SessionIdString开启上传事务时获取到的SessionId
StoreNameStringPhotoStore的名称
UploadTypeString自定义上传类型,比如用dailybackup表示自动备份,manual表示手动上传
RemarkString备注,支持长度为200的中英文字符,html标签将被转义。比如,如果备注中有<,在获取照片信息时<将被转义为<。
LibraryIdString照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。


请求示例https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=CreatePhoto
&FileId=ZUBaS964T3OYtqaal9MaZwAAAApwZDIE
&PhotoTitle=demo-1.jpg
&SessionId=hLB2ktiDiXojjjINEsQNCwACowAAAAFdRAPCZQAAAApwZAYD
&StoreName=cloudphoto-demo
&UploadType=manual
&LibraryId=alice-001
&<公共请求参数>





返回参数

参数名类型说明
RequestIdString唯一标识本次请求的ID
CodeString响应状态码,Success表示成功的响应
MessageString响应状态详细描述
ActionStringCreatePhoto
PhotoPhotoPhoto对象


Photo

参数名类型说明
CtimeString创建的时间戳,单位:毫秒
FileIdString照片对应到存储在OSS上的文件名
HeightInteger照片的高度
IdLong记录的唯一标识
Md5String文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。
MtimeString最后修改的时间戳,单位:毫秒
StateString文件的状态
TitleString照片的名称
WidthInteger照片的宽度
RemarkString备注,200个中英文字符
TakenAtLong照片的拍摄时间戳、单位:毫秒


返回示例


JSON格式 {
    "Action":"CreatePhoto",
    "Message":"success",
    "RequestId":"A793DE62-050F-4D05-94A7-117DD4F97772",
    "Code":"Success",
    "Photo":{
        "Md5":"6b680a5ec98537d18c87e9bb40fc0683",
        "Mtime":1500085463134,
        "State":"active",
        "Height":1200,
        "Id":822879673959591936,
        "Ctime":1500085463134,
        "Width":800,
        "Title":"demo-1.jpg",
        "FileId":"ZUBaS964T3OYtqaal9MaZwAAAApwZDIE",
        "Remark":"",
        "TakenAt":1500085463134
    }
}


XML格式 <?xml version="1.0" encoding="UTF-8"?>
<CreatePhotoResponse>
  <Action>CreatePhoto</Action>
  <Message>success</Message>
  <RequestId>E08384DD-8BD1-45EB-85CE-6B0D1F4B5D4E</RequestId>
  <Photo>
    <Mtime>1499946613428</Mtime>
    <Md5>6b680a5ec98537d18c87e9bb40fc0683</Md5>
    <State>active</State>
    <Height>1200</Height>
    <Ctime>1499946613428</Ctime>
    <Id>822297296078114816</Id>
    <Width>800</Width>
    <FileId>MkM1N9sjSLe_LWWyxcA80wAAAApwZDIE</FileId>
    <Title>demo-1.jpg</Title>
    <Remark><Remark/>
    <TakenAt>1499946613428</TakenAt>
  </Photo>
  <Code>Success</Code>
</CreatePhotoResponse>

XML 存储 JSON API 对象存储 数据格式
分享到
取消 提交回答
全部回答(0)
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

推荐文章
相似问题
推荐课程