HTTP POST를 통해 UploadFile 서블릿에 자산 업로드

Dynamic Media Classic에 에셋을 업로드하면 업로드된 파일과 연관된 모든 로그 활동을 조정하는 작업을 설정하는 하나 이상의 HTTP POST 요청이 포함됩니다.

다음 URL을 사용하여 UploadFile 서블릿에 액세스합니다.

https://<server>/scene7/UploadFile
노트

업로드 작업에 대한 모든 POST 요청은 동일한 IP 주소에서 발생해야 합니다.

Dynamic Media 지역의 URL 액세스

지리적 위치

프로덕션 URL

스테이징 URL(사전 프로덕션 개발 및 테스트에 사용)

북미

https://s7sps1ssl.scene7.com/scene7/UploadFile

https://s7sps1ssl-staging.scene7.com/scene7/UploadFile

유럽, 중동, 아시아

https://s7sps3ssl.scene7.com/scene7/UploadFile

https://s7sps3ssl-staging.scene7.com/scene7/UploadFile

일본/아시아 태평양

https://s7sps5ssl.scene7.com/scene7/UploadFile

https://s7sps5ssl-staging.scene7.com/scene7/UploadFile

업로드 작업 워크플로

업로드 작업은 일반적인 jobHandle을(를) 사용하여 동일한 작업에 처리를 상호 연결하는 하나 이상의 HTTP POST로 구성됩니다. 각 요청은 multipart/form-data 인코딩되어 다음 양식 부분으로 구성됩니다.

노트

업로드 작업에 대한 모든 POST 요청은 동일한 IP 주소에서 발생해야 합니다.

HTTP POST 양식 부분 설명
auth 필수. 인증 및 클라이언트 정보를 지정하는 XML authHeader 문서입니다. SOAP에서 인증 요청​을 참조하십시오.
file params 선택 사항입니다. 각 POST 요청에 업로드할 하나 이상의 파일을 포함할 수 있습니다. uploadPostParams/fileName 매개 변수가 지정되지 않은 경우 각 파일 부분은 Content-Disposition 헤더에 파일 이름 매개 변수를 포함할 수 있으며, 이 매개 변수는 IPS에서 대상 파일 이름으로 사용됩니다.
HTTP POST 양식 부분 uploadPostParams 요소 이름 유형 설명
uploadParams (필수. 업로드 매개 변수를 지정하는 XML uploadParams 문서) companyHandle xsd:string 필수. 파일이 업로드되는 회사에 대해 처리합니다.
uploadParams (필수. 업로드 매개 변수를 지정하는 XML uploadParams 문서) jobName xsd:string jobName 또는 jobHandle 중 하나가 필요합니다. 업로드 작업의 이름입니다.
uploadParams (필수. 업로드 매개 변수를 지정하는 XML uploadParams 문서) jobHandle xsd:string jobName 또는 jobHandle 중 하나가 필요합니다. 이전 요청에서 시작된 업로드 작업을 처리합니다.
uploadParams (필수. 업로드 매개 변수를 지정하는 XML uploadParams 문서) locale xsd:string 선택 사항입니다. 현지화를 위한 언어 및 국가 코드.
uploadParams (필수. 업로드 매개 변수를 지정하는 XML uploadParams 문서) description xsd:string 선택 사항입니다. 작업에 대한 설명입니다.
uploadParams (필수. 업로드 매개 변수를 지정하는 XML uploadParams 문서) destFolder xsd:string 선택 사항입니다. 파일 이름 속성에 접두사를 지정할 Target 폴더 경로, 특히 파일 이름의 전체 경로를 지원하지 않을 수 있는 브라우저 및 기타 클라이언트의 경우.
uploadParams (필수. 업로드 매개 변수를 지정하는 XML uploadParams 문서) fileName xsd:string 선택 사항입니다. 대상 파일의 이름입니다. filename 속성을 무시합니다.
uploadParams (필수. 업로드 매개 변수를 지정하는 XML uploadParams 문서) endJob xsd:boolean 선택 사항입니다. 기본값은 false입니다.
uploadParams (필수. 업로드 매개 변수를 지정하는 XML uploadParams 문서) uploadParams types:UploadPostJob 기존 활성 작업에 대한 후속 요청인 경우 선택 사항입니다. 기존 작업이 있는 경우 uploadParams은 무시되고 기존 작업 업로드 매개 변수가 사용됩니다. UploadPostJob을 참조하십시오.

<uploadPostParams> 블록 내에 포함된 파일의 처리를 지정하는 <uploadParams> 블록이 있습니다.

UploadPostJob을 참조하십시오.

uploadParams 매개 변수는 동일한 작업의 일부로서 개별 파일에 대해 변경할 수 있지만 그렇지 않을 수 있습니다. 전체 작업에 동일한 uploadParams 매개 변수를 사용합니다.

새 업로드 작업에 대한 초기 POST 요청은 jobName 매개 변수를 지정해야 합니다. 고유 작업 이름을 사용하여 후속 작업 상태 폴링 및 작업 로그 쿼리를 간소화할 수 있습니다. 동일한 업로드 작업에 대한 추가 POST 요청은 초기 요청에서 반환된 jobHandle 값을 사용하여 jobName 대신 jobHandle 매개 변수를 지정해야 합니다.

업로드 작업에 대한 최종 POST 요청은 이 작업에 대해 향후 파일이 POST가 되지 않도록 endJob 매개 변수를 true로 설정해야 합니다. 이렇게 하면 모든 POSTed 파일을 인제스트한 직후에 작업을 완료할 수 있습니다. 그렇지 않으면 30분 이내에 추가 POST 요청을 받지 못할 경우 작업이 시간 초과됩니다.

UploadPOST 응답

성공적인 POST 요청의 경우 XSD에서 지정하는 대로 응답 본문은 XML uploadPostReturn 문서가 됩니다.

<element name="uploadPostReturn"> 
        <complexType> 
            <sequence> 
                <element name="jobHandle" type="xsd:string"/> 
            </sequence> 
        </complexType> 
    </element>

반환된 jobHandle은 동일한 작업에 대한 후속 POST 요청에 대해 uploadPostParams/ jobHandle 매개 변수로 전달됩니다. 이 기능을 사용하여 작업 상태를 getActiveJobs 작업으로 폴링하거나 작업 로그를 getJobLogDetails 작업으로 쿼리할 수도 있습니다.

POST 요청을 처리하는 동안 오류가 발생하면 응답 본문은 Faults에 설명된 대로 API 오류 유형 중 하나로 구성됩니다.

POST 요청 예

POST /scene7/UploadFile HTTP/1.1 
User-Agent: Jakarta Commons-HttpClient/3.1 
Host: localhost 
Content-Length: 362630 
Content-Type: multipart/form-data; boundary=O9-ba7tieRtqA4QRSaVk-eDq6658SPrYfvUcJ 
  
--O9-ba7tieRtqA4QRSaVk-eDq6658SPrYfvUcJ 
Content-Disposition: form-data; name="auth" 
Content-Type: text/plain; charset=US-ASCII 
Content-Transfer-Encoding: 8bit 
  
            <authHeader xmlns="http://www.scene7.com/IpsApi/xsd/2014-04-03">  
                   <user>sampleuser@test.com</user>  
                   <password>*</password>  
                   <locale>en-US</locale>  
                   <appName>MyUploadServletTest</appName>  
                   <appVersion>1.0</appVersion>  
                   <faultHttpStatusCode>200</faultHttpStatusCode>  
           </authHeader>                   
        
--O9-ba7tieRtqA4QRSaVk-eDq6658SPrYfvUcJ 
Content-Disposition: form-data; name="uploadParams" 
Content-Type: text/plain; charset=US-ASCII 
Content-Transfer-Encoding: 8bit 
  
            <uploadPostParam xmlns="http://www.scene7.com/IpsApi/xsd/2014-04-03"> 
                <companyHandle>c|2101</companyHandle> 
                <jobName>uploadFileServlet-1376682217351</jobName> 
                <uploadParams> 
                    <overwrite>true</overwrite> 
                    <readyForPublish>true</readyForPublish> 
                    <preservePublishState>true</preservePublishState> 
                    <createMask>true</createMask> 
                    <preserveCrop>true</preserveCrop> 
                    <manualCropOptions> 
                      <left>500</left> 
                      <right>500</right> 
                      <top>500</top> 
                      <bottom>500</bottom> 
                    </manualCropOptions> 
                    <photoshopOptions> 
                      <process>MaintainLayers</process> 
                      <layerOptions> 
                        <layerNaming>AppendNumber</layerNaming> 
                        <anchor>Northwest</anchor> 
                        <createTemplate>true</createTemplate> 
                        <extractText>true</extractText> 
                        <extendLayers>false</extendLayers> 
                      </layerOptions> 
                    </photoshopOptions> 
                    <emailSetting>None</emailSetting> 
                </uploadParams> 
            </uploadPostParam>        
        
--O9-ba7tieRtqA4QRSaVk-eDq6658SPrYfvUcJ-- 
Content-Disposition: form-data; name="file1"; filename="ApiTestCo1/UploadFileServlet1376682217351//1376682217351-1.jpg" 
Content-Type: application/octet-stream; charset=ISO-8859-1 
Content-Transfer-Encoding: binary 
<file bytes ... > 
--O9-ba7tieRtqA4QRSaVk-eDq6658SPrYfvUcJ-- 
Content-Disposition: form-data; name="file2"; filename="ApiTestCo1/UploadFileServlet1376682217351//1376682217351-2.jpg" 
Content-Type: application/octet-stream; charset=ISO-8859-1 
Content-Transfer-Encoding: binary 
<file bytes ... > 
--O9-ba7tieRtqA4QRSaVk-eDq6658SPrYfvUcJ--

POST 응답 예 - 성공

HTTP/1.1 200 OK 
Content-Type: text/xml;charset=utf-8 
Content-Length: 204 
Date: Mon, 25 Jul 2016 19:43:38 GMT 
Server: Unknown 
  
'1.0' encoding='UTF-8'?><uploadPostReturn xmlns="http://www.scene7.com/IpsApi/xsd/2014-04-03"> 
  <jobHandle>j|2101||uploadFileServlet-1376682217351|54091</jobHandle> 
</uploadPostReturn>

POST 응답 예 - 오류

HTTP/1.1 200 OK 
Content-Type: text/xml;charset=utf-8 
Content-Length: 210 
Date: Mon, 25 Jul 2016 19:43:38 GMT 
Server: Unknown 
  
<?xml version='1.0' encoding='UTF-8'?><tns:authenticationFault xmlns:tns="http://www.scene7.com/IpsApi/xsd"><tns:code>10001</tns:code><tns:reason>Invalid username/password</tns:reason></tns:authenticationFault> 
 

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now