アップロードトークンの取得

アップロードトークン は、ほかのユーザが同じ共有秘密キーを使用してアセットをアップロードすることができないようにします。つまり、アップロードの合法性とソースの信頼性を確保します。

アップロードトークンは英数字で構成された文字列で、一定の期間しか利用できません。アップロードトークンを取得するために共有秘密キーを送信する場合は、以下の 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：

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

これで、画像アセットをアップロードできるようになりました。

詳しくは、 画像アセットのアップロード を参照してください。

Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。