래스터 이미지 자산 업로드 uploading-an-image-asset-or-a-vector-asset
이미지 자산을 업로드하려면 먼저 공유 비밀 키를 요청합니다. 이 공유 보안 키를 사용하여 업로드 토큰을 검색합니다. 그런 다음 업로드 토큰을 사용하여 래스터 이미지 에셋을 업로드합니다.
공유 암호 키 요청 requesting-a-shared-secret-key
Admin Console을 사용하여 공유 암호 키 를 요청하여 지원 사례를 만듭니다. 기술 지원 사례에서 공유 암호 키를 요청합니다.
이메일 메시지에 이미지 자산을 업로드하는 데 사용할 회사 이름을 제공합니다. Adobe Dynamic Media Classic에서 키를 받으면 나중에 사용할 수 있도록 로컬에 저장합니다.
업로드 토큰 검색 retrieving-the-upload-token
업로드 토큰 은 아무도 동일한 공유 보안 키를 사용하여 자산을 업로드할 수 없게 하며, 업로드가 합법적이고 신뢰할 수 있는 소스에서 제공된 것인지 확인합니다.
업로드 토큰은 특정 시간 동안만 사용할 수 있는 영숫자 문자열입니다. 업로드 토큰을 검색할 수 있도록 다음 URL을 사용하여 공유 암호 키를 대체하십시오.
- 래스터 이미지
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602이 예제에서 공유 암호 키는fece4b21-87ee-47fc-9b99-2e29b78b602입니다.
기본적으로 업로드 토큰은 검색한 지 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
허용된 HTTP 메서드:GET 및 POST
이제 이미지 자산을 업로드할 수 있습니다.
이미지 자산 업로드를 참조하십시오.
래스터 이미지 자산 업로드 uploading-an-image-asset
특정 시간 동안 유효한 업로드 토큰을 검색한 후 이미지 자산을 업로드할 수 있습니다. 다음 예와 같이 자산을 멀티파트/양식 게시로 업로드하고 나머지 값을 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 매개 변수는 업로드에 허용되는 파일 이름 확장명을 지정합니다. 두 값은 모두 선택 사항입니다.
허용되는 파일 이름 확장자와 파일 크기 제한에 대해 애플리케이션에서 글로벌 제한이 설정됩니다. 요청에서 보낸 내용이 전역 제한의 하위 세트인 경우 적용됩니다. 글로벌 제한은 다음과 같습니다.
다음 HTML 양식을 사용하여 자산을 업로드할 수 있습니다. 이 양식에서 사용자는 다음 정보를 입력해야 합니다.
- 회사 이름.
- 업로드 토큰.
- 파일 크기 제한.
- 파일 이름 확장자 목록입니다.
- 자산과 연결된 색상 프로파일 및 파일 이름을 유지할지 여부입니다.
- 녹아웃 배경 사용 여부. [녹아웃 배경]을 활성화하면 [모퉁이], [허용치] 및 [채우기 방법]을 설정합니다.
업로드 시 이미지 미세 조정 옵션에서 녹아웃 배경 을 참조하십시오. - 업로드할 파일의 이름입니다.
https://s7ugc1.scene7.com/ugc/upload.html을(를) 선택하여 위의 양식과 연결된 HTML 소스 코드를 볼 수 있습니다.
Firefox에서 브라우저 창을 마우스 오른쪽 단추로 클릭한 다음 페이지 Source 보기 를 선택합니다. 이 코드는 사용자가 제출 을 선택할 때 실행되는 해당 URL 쿼리 문자열과 POST 메서드를 보여 줍니다.
Internet Explorer에서 XML 응답을 보려면 보기 > Source(으)로 이동하십시오. 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>https://s7w2p1.scene7.com/is/image/ </url>
<path>000Company/ugc/1442564.tif</path>
<fullurl>https://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl>
</message>
</response>
</user_generated_content>
</scene7>
자산은 다른 ImageServing 리소스와 같으며, 자산에 처리 쿼리를 적용할 수 있습니다. 예를 들어 다음 URL은 지정된 너비 및 높이까지 확장된 에셋을 요청합니다.
https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch
멀티파트/양식 게시로 업로드할 자산을 보내고 나머지 값을 URL 쿼리 문자열로 보냅니다. URL 쿼리 문자열에 다음 필드를 사용하여 자산을 업로드할 수 있습니다.
opupload_tokencompany_namefile_limitfile_extspreserve_colorprofilepreserve_filename샘플 URL:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
허용되는 HTTP 메서드:
POST
이미지에 대한 자산 메타데이터 가져오기 getting-asset-metadata-for-images
다음 예제와 같이 image_info을(를) 사용하여 업로드한 에셋의 메타데이터를 검색할 수 있습니다.
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
성공적인 응답의 예는 다음과 유사하게 표시됩니다.
<?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>image_info</operationName>
<serviceStatus>SUCCESS</serviceStatus>
<title>More information on 1442564.tif</title>
<message>
File created on Tue Sep 08 19:02:04 CDT 2009, File Size = 243494 bytes
<imageFormat>Tiff</imageFormat>
<colorSpace>Rgb</colorSpace>
<width>686</width>
<height>457</height>
</message>
</response>
</user_generated_content>
</scene7>
URL 쿼리 문자열에 다음 필드를 사용하여 자산에 대한 정보를 요청할 수 있습니다.
opshared_secretimage_name샘플 URL:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
허용되는 HTTP 메서드:
GET 및 POST