특정 시간 동안 유효한 업로드 토큰을 검색한 후 이미지 자산을 업로드할 수 있습니다. 다음 예와 같이 자산을 멀티파트/양식 게시로 업로드하고 나머지 값을 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 코드는 브라우저 창에서 마우스 오른쪽 단추를 클릭한 다음 그림에 표시된 양식에 대해
[소스 보기]
를 클릭할 때 표시됩니다. 이 코드는 사용자가 [전송]을 클릭할 때 실행되는 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"> 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 <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 <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