이미지 자산 업로드

특정 시간 동안 유효한 업로드 토큰을 검색한 후 이미지 자산을 업로드할 수 있습니다. 다음 예와 같이 자산을 멀티파트/양식 게시로 업로드하고 나머지 값을 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 매개 변수는 파일 크기 제한(바이트)을 지정합니다. file_exts 매개 변수는 업로드할 수 있는 파일 이름 확장자를 지정합니다. 두 값은 모두 선택 사항입니다.

허용되는 파일 이름 확장자와 파일 크기 제한에 대해 애플리케이션에서 글로벌 제한이 설정됩니다. 요청에 보내는 내용이 글로벌 제한의 하위 집합이면 허용됩니다. 글로벌 제한은 다음과 같습니다.

글로벌 제한	값
모든 클라이언트의 파일 크기	20 MB
업로드가 지원되는 이미지 파일 형식	BMP, GIF, JPG, PNG, PSD

다음 HTML 양식을 사용하여 자산을 업로드할 수 있습니다. 이 양식에서 사용자는 다음 정보를 입력해야 합니다.

회사 이름
업로드 토큰
파일 크기 제한
파일 이름 확장자 목록
업로드할 파일 이름

전체 화면으로 그래픽 보기

자산 업로드에 사용되는 HTML 양식

다음 HTML 코드는 브라우저 창에서 마우스 오른쪽 단추를 클릭한 다음 그림에 표시된 양식에 대해 [소스 보기] 를 클릭할 때 표시됩니다. 이 코드는 사용자가 [전송]을 클릭할 때 실행되는 POST 메서드와 해당 URL 쿼리 문자열을 보여 줍니다.

<html> 
<body> 
    <script language="javascript"> 
        function uploadImage() 
        { 
            var preserve_colorprofile = "false"; 
            if(document.image_upload.preserve_colorprofile[0].checked == true){ 
                preserve_colorprofile = "true"; 
            } 
            var preserve_filename = "false"; 
            if(document.image_upload.preserve_filename[0].checked == true){ 
                preserve_filename = "true"; 
            } 
document.image_upload.action="https://s7ugc1.scene7.com/ugc/image?op=upload&company_name="+document.image_upload.company_name.value+"&upload_token="+document.image_upload.upload_token.value+"&file_limit="+document.image_upload.file_limit.value+"&file_exts="+document.image_upload.file_exts.value+"&preserve_colorprofile="+preserve_colorprofile+"&preserve_filename="+preserve_filename; 
            return true; 
        } 
    </script> 
<form method="POST" enctype="multipart/form-data" name="image_upload" id="image_upload" onSubmit="return uploadImage();"> 
<table> 
<tr><td colspan="2"><strong> UGC Image Upload Test Page: </strong></td></tr> 
<tr><td colspan="2"></td></tr> 
<tr><td><strong> Company Name</strong></td><td><input type="text" size="40" name="company_name"></td></tr> 
<tr><td><strong> Upload Token </strong></td><td><input type="text" size="40" name="upload_token"></td></tr> 
<tr><td><strong> File Size Limit (in bytes) </strong></td><td><input type="text" size="40" name="file_limit">&nbsp;bytes</td></tr> 
<tr><td><strong> File Extensions allowed </strong></td><td><input type="text" size="40" name="file_exts"></td></tr> 
<tr><td><strong> Preserve Color Profile</strong></td><td><input type="radio"  name="preserve_colorprofile" value="true">Yes&nbsp;&nbsp;<input type="radio"  name="preserve_colorprofile" value="false" checked>No</td></tr> 
<tr><td><strong> Preserve File Name</strong></td><td><input type="radio"  name="preserve_filename" value="true">Yes&nbsp;&nbsp;<input type="radio"  name="preserve_filename" value="false" checked>No</td></tr> 
<tr><td colspan="2"></td></tr> 
<tr> 
    <td><strong>File to upload: : </strong></td> 
    <td><input name="filename" type="file" id="filename" size="58" maxlength="1024" /></td> 
</tr> 
<tr><td colspan="2"></td></tr> 
<tr> 
    <td><strong>Click Submit to upload your image: </strong></td> 
    <td><input type="submit" value="Submit"></td> 
</tr> 
</table> 
</form> 
</body> 
</html>

Internet Explorer에서 XML 응답을 보려면 [보기] > [소스] 를 클릭합니다. Firefox에서 XML 응답을 보려면 [보기] > [페이지 소스] 를 클릭합니다. XML 응답을 보려는 경우 Firefox를 사용하는 것이 좋습니다.

다음은 성공적인 업로드에 대한 샘플 응답입니다.

<?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>http://s7w2p1.scene7.com/is/image/ </url> 
            <path>000Company/ugc/1442564.tif</path> 
            <fullurl>http://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl> 
            </message> 
        </response> 
    </user_generated_content> 
</scene7>

참고: 업로드한 자산(JPG, GIF 등)이 PTIFF 형식으로 전환되고 응답에서 해당 PTIFF 자산에 대한 직접 링크를 보냅니다.

자산은 다른 ImageServing 리소스와 같으며, 자산에 처리 쿼리를 적용할 수 있습니다. 예를 들어 다음 URL은 지정한 너비와 높이로 늘린 자산을 요청합니다.

http://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch

멀티파트/양식 게시로 업로드할 자산을 보내고 나머지 값을 URL 쿼리 문자열로 보냅니다. URL 쿼리 문자열에 다음 필드를 사용하여 자산을 업로드할 수 있습니다.

URL 매개 변수	필수 또는 선택 사항	값
`op`	필수	`upload`
`upload_token`	필수	회사와 관련된 공유 보안 키의 업로드 토큰입니다.
`company_name`	필수	업로드를 수행하는 회사 이름입니다.
`file_limit`	선택적	자산의 파일 크기 제한(바이트)입니다.
`file_exts`	선택적	이미지 자산 파일에 허용되는 확장자 목록입니다.
`preserve_colorprofile`	선택적	임베드된 색상 프로필을 유지하고 업로드한 파일을 PTIFF 형식으로 전환합니다. 가능한 값은 true 또는 false입니다. 기본값은 false입니다.
`preserve_filename`	선택적	업로드한 자산의 파일 이름을 유지합니다. 가능한 값은 true 또는 false입니다. 기본값은 false입니다.

참고: 업로드할 자산을 멀티파트 POST 요청의 유일한 필드로 보내야 합니다.

샘플 URL:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

허용되는 HTTP 메서드:

POST