全部产品

CreatePhoto

描述

提交事务以完成上传照片。

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

请求参数

参数名 类型 是否必须 说明
Action String CreatePhoto
FileId String 开启上传事务时获取到的文件ID
PhotoTitle String 照片的名称
SessionId String 开启上传事务时获取到的SessionId
StoreName String PhotoStore的名称
UploadType String 自定义上传类型,比如用dailybackup表示自动备份,manual表示手动上传
Remark String 备注,支持长度为2048的中英文字符。如果Remark的内容有可能被显示在网页中,请在显示时对Remark内容做html转义以防止被注入攻击。
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。
ShareExpireTime Long 可选值0或者大于当前时间的时间戳(单位:毫秒),不可以小于当前时间。当值大于当前时间戳时,表示在该时间戳之前,可以生成供公共访问的访问地址。默认值为0表示只能生成带鉴权访问的访问地址。参见分享照片
Staging Boolean 可选值:true,false。默认值为false。当为true时,表示照片上传后的默认状态为staging。参见照片审核
TakenAt Long 指定照片的拍摄时间戳。如果照片中没有Exif,或者Exif中没有照片的拍摄时间,将采用该参数指定的值作为照片的拍摄时间。合法取值为13位数字,大于0且小于当前时间戳。单位:毫秒。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=CreatePhoto
  2. &FileId=ZUBaS964T3OYtqaal9MaZwAAAApwZDIE
  3. &PhotoTitle=demo-1.jpg
  4. &SessionId=hLB2ktiDiXojjjINEsQNCwACowAAAAFdRAPCZQAAAApwZAYD
  5. &StoreName=cloudphoto-demo
  6. &UploadType=manual
  7. &LibraryId=alice-001
  8. &ShareExpireTime=1530085463134
  9. &Staging=false
  10. &<公共请求参数>

返回参数

参数名 类型 说明
RequestId String 唯一标识本次请求的ID
Code String 响应状态码,Success表示成功的响应
Message String 响应状态详细描述
Action String CreatePhoto
Photo Photo Photo对象

Photo

参数名 类型 说明
Ctime String 创建的时间戳,单位:毫秒
FileId String 照片对应到存储在OSS上的文件名
Height Integer 照片的高度
Id Long 记录的唯一标识
Md5 String 文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。
Mtime String 最后修改的时间戳,单位:毫秒
State String 文件的状态
Title String 照片的名称
Width Integer 照片的宽度
Remark String 备注,200个中英文字符
TakenAt Long 照片的拍摄时间戳、单位:毫秒

返回示例

JSON格式

  1. {
  2. "Action":"CreatePhoto",
  3. "Message":"success",
  4. "RequestId":"A793DE62-050F-4D05-94A7-117DD4F97772",
  5. "Code":"Success",
  6. "Photo":{
  7. "Md5":"6b680a5ec98537d18c87e9bb40fc0683",
  8. "Mtime":1500085463134,
  9. "State":"active",
  10. "Height":1200,
  11. "Id":822879673959591936,
  12. "Ctime":1500085463134,
  13. "Width":800,
  14. "Title":"demo-1.jpg",
  15. "FileId":"ZUBaS964T3OYtqaal9MaZwAAAApwZDIE",
  16. "Remark":"",
  17. "TakenAt":1500085463134,
  18. "ShareExpireTime": 1530085463134
  19. }
  20. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <CreatePhotoResponse>
  3. <Action>CreatePhoto</Action>
  4. <Message>success</Message>
  5. <RequestId>E08384DD-8BD1-45EB-85CE-6B0D1F4B5D4E</RequestId>
  6. <Photo>
  7. <Mtime>1499946613428</Mtime>
  8. <Md5>6b680a5ec98537d18c87e9bb40fc0683</Md5>
  9. <State>active</State>
  10. <Height>1200</Height>
  11. <Ctime>1499946613428</Ctime>
  12. <Id>822297296078114816</Id>
  13. <Width>800</Width>
  14. <FileId>MkM1N9sjSLe_LWWyxcA80wAAAApwZDIE</FileId>
  15. <Title>demo-1.jpg</Title>
  16. <Remark><Remark/>
  17. <TakenAt>1499946613428</TakenAt>
  18. <ShareExpireTime>1530085463134</ShareExpireTime>
  19. </Photo>
  20. <Code>Success</Code>
  21. </CreatePhotoResponse>