在上载图像资源之前,必须先请求一个共享密钥。可以使用该共享密钥检索上载令牌。然后,使用上传令牌上传光栅图像资产。
从2023年5月1日开始,Dynamic Media中的UGC资源最多可在上传日期后60天内使用。 60天后,这些资产将被删除。
对Adobe Dynamic Media Classic中新增或现有UGC矢量资源的支持已于2021年9月30日终止。
请求 共享密钥 作者: 使用Admin Console创建支持案例。 在您的支持案例中,请求共享密钥。
在电子邮件中,请提供要用于上载图像资源的公司名称。从Adobe Dynamic Media Classic收到密钥后,请将其保存在本地以供将来使用。
上载令牌可确保他人不能使用相同的共享密钥来上载资源。它可确保上载合法且来自信任的来源。
上载令牌是字母数字字符串,只能在特定时间段内使用。使用以下URL替换共享密钥,以便检索上载令牌。
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602
在此示例中,共享密钥为 fece4b21-87ee-47fc-9b99-2e29b78b602
默认情况下,上载令牌在您检索到它之后 5 分钟(300 秒)便到期。要请求更多时间,请在 URL 中添加 expires
和要需要的时间量(以秒为单位)。例如,以下示例图像 URL 检索有效期为 1800 秒的上载令牌:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800
图像的成功响应类似于以下内容:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>get_uploadtoken</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>Upload Token for fece4b21-87ee-47fc-9b99-2e29b78b602</title>
<message>
<uploadtoken>aa2a378a-cd25-4c80-994d-312094e0ef20_1800</uploadtoken>
<expiration_in_seconds>1800</expiration_in_seconds>
</message>
</response>
</user_generated_content>
</scene7>
将上载令牌保存到本地,以备以后请求时使用。
您可以在查询 URL 字符串中使用以下字段来检索上载令牌:
URL 参数 | 必需或可选 | 值 |
---|---|---|
op | 必需 | get_uploadtoken |
shared_secret | 必需 | 正在进行上载的公司的共享密钥。 |
expires | 可选 | 上载令牌有效的秒数。如果不指定,则默认为 300 秒。 |
栅格图像URL示例:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
允许的HTTP方法:
GET
和 POST
您现在可以上载图像资源。
参见 上传图像资源.
您检索到在特定时间内有效的上载令牌后,即可上载图像资源。以 multipart/form post 形式上载资源,而值的其余部分以 URL 查询字符串形式发送,如以下示例中所示:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
此 upload_token
和 company_name
字段为必填项。
参见 检索上传令牌.
参见 检索共享密钥.
您还能以 URL 查询字符串的形式发送其他可选值,如以下示例所示:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=jpg,gif
此 file_limit
parameter指定文件大小限制(以字节为单位)。 file_exts
参数指定允许上载的文件扩展名。这两个值都是可选的。
对于允许的文件大小限制和文件扩展名,在应用程序中设置全局限制。如果请求中所发送的内容是全局限制的子集,则允许这一发送。全局限制如下所示:
全局限制 | 值 |
---|---|
所有客户端的文件大小 | 20 MB |
用于上载的支持的图像文件格式 | BMP、GIF、JPG、PNG、PSD,TIFF |
用户可通过下面的 HTML 表单上载资源。表单要求用户输入以下信息:
您可以通过选择查看与上述表单关联的HTML源代码 https://s7ugc1.scene7.com/ugc/upload.html
在Firefox中,右键单击浏览器窗口,然后选择 查看页面源. 该代码将显示当用户单击“提交”时运行的相应 URL 查询字符串和 POST 方法。
要在Internet Explorer中查看XML响应,请转到 视图 > 来源. 要在Firefox中查看XML响应,请转到 工具 > 浏览器工具 > Web开发人员工具. 建议使用 Firefox 查看 XML 响应。
下面是成功上载的示例响应:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>upload</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>Your file has been uploaded Successfully.</title>
<message>
<url>https://s7w2p1.scene7.com/is/image/ </url>
<path>000Company/ugc/1442564.tif</path>
<fullurl>https://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl>
</message>
</response>
</user_generated_content>
</scene7>
上载的资源(JPG、GIF 等)转换为 PTIFF 格式,响应向该 PTIFF 资源发送直接链接。
该资源类似于任何其他的图像服务资源;您可以对其应用处理查询。例如,以下 URL 请求拉伸到指定宽度和高度的资源。
https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch
以 multipart/form post 形式发送要上载的资源,而值的其余部分以 URL 查询字符串形式发送。您可以在 URL 查询字符串中使用以下字段来上载资源:
URL 参数 | 必需或可选 | 值 |
---|---|---|
op |
必需 | 上载 |
upload_token |
必需 | 与公司关联的共享密钥的上载令牌。 |
company_name |
必需 | 执行上载的公司的名称。 |
file_limit |
可选 | 资源的文件大小限制(以字节为单位)。 |
file_exts |
可选 | 图像资源文件容许扩展名的列表。 |
preserve_colorprofile |
可选 | 用于在将上载文件转换成 PTIFF 格式时保留任何嵌入的颜色配置文件。可能的值为 true 或 false。默认值为 false。 |
preserve_filename |
可选 | 保留所上载资源的文件名。可能的值为 true 或 false。默认值为 false。 |
须将待上载资源作为 multipart POST 请求中的唯一字段发送。
示例 URL:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
允许的 HTTP 方法:
POST
您可以使用 image_info
检索所上载资源的元数据,如以下示例中所示:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
成功响应的示例如下所示:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
<user_generated_content>
<response>
<serviceName>User Generated Content - Images</serviceName>
<version>1.0.0</version>
<operationName>image_info</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>More information on 1442564.tif</title>
<message>
File created on Tue Sep 08 19:02:04 CDT 2009, File Size = 243494 bytes
<imageFormat>Tiff</imageFormat>
<colorSpace>Rgb</colorSpace>
<width>686</width>
<height>457</height>
</message>
</response>
</user_generated_content>
</scene7>
您可以在 URL 查询字符串中使用以下字段请求有关资源的信息:
URL 参数 | 必需或可选 | 值 |
---|---|---|
op |
必需 | image_info |
shared_secret |
必需 | 公司的共享密钥。 |
image_name |
必需 | 图像的名称。 |
示例 URL:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
允许的 HTTP 方法:
GET 和 POST