› 推特 ›阿里云技术文档›正文

CreatePhoto_照片接口_API手册_智能云相册

admin 阿里云技术文档 2020-02-11 222 0

阿里云服务器优惠

CreatePhoto

描述

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

请在使用该接口前确认已完全理解了上传流程中的内容。
调用该接口前需要开启事务，请参考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且小于当前时间戳。单位：毫秒。

请求示例

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

返回参数

参数名	类型	说明
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格式

{
    "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,
        "ShareExpireTime": 1530085463134
    }
}

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>
    <ShareExpireTime>1530085463134</ShareExpireTime>
  </Photo>
  <Code>Success</Code>
</CreatePhotoResponse>

版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----