擷取上載標記

上載標記 將確保他人不能使用相同的共用密鑰來上載資產。它確保上載合法且來自信任的來源。

上載標記是字母數字字串,只能在指定時間內使用。請使用以下 URL 代替您的共用密鑰來擷取上載標記。

  • 影像

    https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602

    在本例中,共用密鑰為 fece4b21-87ee-47fc-9b99-2e29b78b602

  • 向量

    https://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79-a1a5-9ac2875429b9

    在本例中,共用密鑰為 2d19f60e-890a-4e79-a1a5-9ac2875429b9

根據預設,上載標記在您擷取之後 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

您現在可以上載影像資產。

請參閱 上載影像資產