上載標記
將確保他人不能使用相同的共用密鑰來上載資產。它確保上載合法且來自信任的來源。
上載標記是字母數字字串,只能在指定時間內使用。請使用以下 URL 代替您的共用密鑰來擷取上載標記。
根據預設,上載標記在您擷取之後 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
範例向量 URL:
http://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79-a1a5-9ac2875429b9&expires=5000
允許的 HTTP 方式:
GET 和 POST
您現在可以上載影像資產。
請參閱
上載影像資產
。
|
|
|