래스터 이미지 자산 업로드 uploading-an-image-asset-or-a-vector-asset
이미지 자산을 업로드하려면 먼저 공유 비밀 키를 요청합니다. 이 공유 보안 키를 사용하여 업로드 토큰을 검색합니다. 그런 다음 업로드 토큰을 사용하여 래스터 이미지 에셋을 업로드합니다.
공유 암호 키 요청 requesting-a-shared-secret-key
요청 a 공유 암호 키 작성자: 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초) 후에 만료됩니다. 더 많은 시간을 요청하려면 다음을 포함하십시오. 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 양식을 사용하여 자산을 업로드할 수 있습니다. 이 양식에서 사용자는 다음 정보를 입력해야 합니다.
- 회사 이름.
- 업로드 토큰.
- 파일 크기 제한.
- 파일 이름 확장자 목록입니다.
- 자산과 연결된 색상 프로파일 및 파일 이름을 유지할지 여부입니다.
- 녹아웃 배경 사용 여부. [녹아웃 배경]을 활성화하면 [모퉁이], [허용치] 및 [채우기 방법]을 설정합니다.
에서 녹아웃 배경 보기 업로드 시 이미지 세부 조정 옵션. - 업로드할 파일의 이름입니다.
을(를) 선택하여 위 양식과 연결된 HTML 소스 코드를 볼 수 있습니다. https://s7ugc1.scene7.com/ugc/upload.html
Firefox에서 브라우저 창을 마우스 오른쪽 단추로 클릭하고 를 선택합니다. 페이지 소스 보기. 이 코드는 사용자가 선택할 때 실행되는 해당 URL 쿼리 문자열 및 POST 메서드를 보여 줍니다 제출.
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>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 쿼리 문자열에 다음 필드를 사용하여 자산을 업로드할 수 있습니다.
op
upload_token
company_name
file_limit
file_exts
preserve_colorprofile
preserve_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 쿼리 문자열에 다음 필드를 사용하여 자산에 대한 정보를 요청할 수 있습니다.
op
shared_secret
image_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