{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"개요","type":"text"}]},{"type":"paragraph","content":[{"text":"Kollus HTTP 업로드 Endpoint는 고객사가 업로드를 원하는 시점에 Kollus Open API의 일회성 업로드 URL 발급 API를 호출하여 획득한 업로드 URL로 HTTP multipart/form-data 형식으로 파일을 업로드하여, 이후 과정 (트랜스코딩) 을 진행토록 합니다.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Use case scenario","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"490","id":"9df9504d-fae4-4cce-a333-4afc7708e04d","collection":"contentId-3311241","height":"250"}}}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"사용자가 고객사의 Web 사이트에서 동영상 파일을 업로드 하기 위해 특정 페이지를 요청합니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"고객사 업로드 페이지에서 사용자에게 업로드 경로를 반환하기 위해 Kollus Api를 이용해 업로드 URL 생성을 요청합니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"업로드 URL 생성 요청에 대한 반환으로 업로드 URL과 업로드 파일키(Upload file key), 키 만료시간 정보등을 획득합니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3에서 반환 받은 업로드 URL 정보를 기반으로 고객에게 보여지는 업로드 페이지를 생성합니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"고객사의 업로드 페이지에서 업로드를 하면 실제 업로드는 고객사의 웹사이트가 아닌 Kollus 업로드 서버로 직접 전송하게 됩니다.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"유의사항","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP 프로토콜을 이용한 업로드를 지원하기 위해 사용자에게 업로드에 필요한 정보를 생성하는 API를 제공합니다. HTTP Upload API는 아래와 같은 특성을 갖습니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"생성된 업로드 URL, 업로드 파일키는 일회용입니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"생성된 업로드 파일키는 지정된 시간 이후 자동 폐기됩니다.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"요청규격","type":"text"}]},{"type":"paragraph","content":[{"text":"업로드 엔드포인트 생성 API ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#505050"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"일반 업로드 URL : ","type":"text"},{"text":"https://c-api-kr.kollus.com/api/upload/create-url","type":"text","marks":[{"type":"link","attrs":{"href":"https://c-api-kr.kollus.com/api/upload/create-url"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"패스쓰루, 파일라이브 업로드 URL : ","type":"text"},{"text":"http(s)://upload.kr.kollus.com/api/v1/create_url","type":"text","marks":[{"type":"link","attrs":{"href":"http://upload.kr.kollus.com/api/v1/create_url"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Query Parameters ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#505050"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"access_token (","type":"text","marks":[{"type":"textColor","attrs":{"color":"#505050"}}]},{"text":"API 접근토큰","type":"text","marks":[{"type":"textColor","attrs":{"color":"#505050"}},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"비디오 연동 키 (KEY) -VOD | LIVE 통합","versionAtSave":"20"},"href":"https://catenoid-support.atlassian.net/wiki/spaces/SUP/pages/3311232"}}]},{"text":")","type":"text","marks":[{"type":"textColor","attrs":{"color":"#505050"}}]}]}]}]},{"type":"paragraph","content":[{"text":"업로드 URL 발급 요청시에는 다음과 같은 파라미터를 설정할 수 있습니다. Request는 Kollus API 정책에 따라 HTTP(80), HTTPS(443), POST Method만 지원합니다.","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","width":1800.0,"localId":"315e5f1b-a04c-45e2-a237-99596cbfd223"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[195.89]},"content":[{"type":"paragraph","content":[{"text":"POST key","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.95]},"content":[{"type":"paragraph","content":[{"text":"Data type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.83]},"content":[{"type":"paragraph","content":[{"text":"기본값","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[889.26]},"content":[{"type":"paragraph","content":[{"text":"비고","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[195.89]},"content":[{"type":"paragraph","content":[{"text":"expire_time","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.95]},"content":[{"type":"paragraph","content":[{"text":"integer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.83]},"content":[{"type":"paragraph","content":[{"text":"600 (초)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[889.26]},"content":[{"type":"paragraph","content":[{"text":"값의 범위는 0 < expire_time <= 21600 입니다. 빈값을 보내거나 항목 자체를 제거하면 기본 600초로 설정됩니다.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[195.89]},"content":[{"type":"paragraph","content":[{"text":"category_key","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.95]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.83]},"content":[{"type":"paragraph","content":[{"text":"(없음)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[889.26]},"content":[{"type":"paragraph","content":[{"text":"업로드한 파일이 속할 카테고리의 키입니다. 빈값을 보내거나 항목 자체를 제거하면 ‘없음’에 속합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"파일라이브 업로드의 경우 콜러스 VOD의 Kollus_FileLive 카테고리의 키를 지정합니다.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[195.89]},"content":[{"type":"paragraph","content":[{"text":"title","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.95]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.83]},"content":[{"type":"paragraph","content":[{"text":"(없음)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[889.26]},"content":[{"type":"paragraph","content":[{"text":"입력한 제목을 컨텐츠의 제목으로 강제지정합니다. 이 값을 보내지 않거나 빈 값으로 보내면 기본적으로 파일명이 제목으로 사용됩니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"is_passthrough를 1로 설정시 title은 원본파일명으로 지정됩니다.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[195.89]},"content":[{"type":"paragraph","content":[{"text":"is_encryption_upload","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.95]},"content":[{"type":"paragraph","content":[{"text":"integer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.83]},"content":[{"type":"paragraph","content":[{"text":"0 (일반)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[889.26]},"content":[{"type":"paragraph","content":[{"text":"0은 일반 업로드, 1은 암호화 업로드입니다. 암호화 업로드시 파일이 암호화 되어 Kollus의 전용 플레이어로만 재생됩니다. Security-pack이 적용되지 않은 서비스 계정에서 이 값을 1로 지정하여 요청한 경우는 업로드 URL 생성이 실패합니다.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[195.89]},"content":[{"type":"paragraph","content":[{"text":"is_audio_upload","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.95]},"content":[{"type":"paragraph","content":[{"text":"integer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.83]},"content":[{"type":"paragraph","content":[{"text":"0 (비디오)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[889.26]},"content":[{"type":"paragraph","content":[{"text":"0은 비디오 업로드, 1은 음원 파일 업로드 입니다.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[195.89]},"content":[{"type":"paragraph","content":[{"text":"is_passthrough","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.95]},"content":[{"type":"paragraph","content":[{"text":"integer","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.83]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[889.26]},"content":[{"type":"paragraph","content":[{"text":"1은 passthrough 업로드, 0은 일반 업로드 입니다.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[195.89]},"content":[{"type":"paragraph","content":[{"text":"profile_key","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.95]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.83]},"content":[{"type":"paragraph","content":[{"text":"(패스쓰루 사용 시 필수)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[889.26]},"content":[{"type":"paragraph","content":[{"text":"is_passthrough가 1인 경우 의미가 있습니다. (profile_key={계정명}-pc-high)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"paragraph","content":[{"text":"설정->고급기능->인코딩 프로파일에서 확인가능합니다.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[195.89]},"content":[{"type":"paragraph","content":[{"text":"selected_profile_key","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.95]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.83]},"content":[{"type":"paragraph","content":[{"text":"(없음)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[889.26]},"content":[{"type":"paragraph","content":[{"text":"파일라이브의 업로드 경우에만 사용 합니다. 값 : (서비스계정키)-filelive","type":"text"}]},{"type":"paragraph","content":[{"text":"콜러스 라이브의 파일라이브가 활성화 상태에만 유효 합니다.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"응답규격","type":"text"}]},{"type":"paragraph","content":[{"text":"JSON / UTF-8 으로 결과를 반환 합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"(# upload_url에 사용되는 도메인 정보를 포함한 모든 정보는 Kollus 시스템 정책에 의해 변경될 수 있습니다.)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"Sample\n{\n \"error\": 0,\n \"message\": \"\",\n \"result\": {\n \"upload_url\": \"https://upload.kr.kollus.com/api/v1/UploadMultiParts/KUS_BOHG2eTQhPSIaG2511G1jfkpWOYAOjDc/20151204-dh6o2goz\",\n “progress_url”: “https://upload.kr.kollus.com/api/v1/GetUploadingProgress/KUS_BOHG2eTQhPSIaG2511G1jfkpWOYAOjDc”,\n \"upload_file_key\": \"20141017-y4sae7td\",\n \"will_be_expired_at\": 1413883670\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"JSON Structure Description","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"error : 에러코드, 0이면 정상","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"message : 에러의 경우 상세 설명이 포함됩니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"result : 정상인 경우 업로드 API 호출 결과를 포함 합니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"upload_url : 업로드할 URL (HTTP)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"progress_url : 업로드 진행률을 획득할 수 있는 URL (HTTP)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"upload_file_key : 업로드 파일키","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"will_be_expired_at : upload_file_key 만료 시간 (unix timestamp)","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"파일업로드","type":"text"}]},{"type":"paragraph","content":[{"text":"업로드 URL 발급요청 API를 통해 획득한 업로드 URL(upload_url)이 실제 파일을 전송할 업로드 서버의 주소입니다. 이 주소에 대해 HTML multipart/form-data 형식으로 파일을 전송해야 합니다.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"유의사항","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"전송할 파일의 input name은 upload-file입니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"하나의 업로드 URL은 하나의 파일에 대응합니다. (하나의 업로드 URL로 하나 이상의 파일을 전송하려 시도할 경우 뒤에 업로드하는 파일의 업로드는 실패합니다.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"업로드는 업로드 URL의 만료시간 전까지 완료되어야 합니다. 만료시간 판단은 업로드 시작 시점이 아니라 종료 시점에 판단합니다.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"업로드 옵션","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","width":1800.0,"localId":"c9a2fbef-b3ef-42cc-958d-ef68d02d1f91"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[173.0]},"content":[{"type":"paragraph","content":[{"text":"POST key","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"Data type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[281.0]},"content":[{"type":"paragraph","content":[{"text":"기본값","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1233.0]},"content":[{"type":"paragraph","content":[{"text":"비고","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[173.0]},"content":[{"type":"paragraph","content":[{"text":"return_url","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[281.0]},"content":[{"type":"paragraph","content":[{"text":"(없음)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1233.0]},"content":[{"type":"paragraph","content":[{"text":"return_url이 주어지면 업로드 종료 후 해당 url로 redirect 합니다. 이때, result와 message값을 추가합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"예> https://foo.com/result.html?result=S&message=...","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[173.0]},"content":[{"type":"paragraph","content":[{"text":"disable_alert","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"integer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[281.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1233.0]},"content":[{"type":"paragraph","content":[{"text":"기본적으로는 업로드 종료시 결과 메세지를 alert로 뿌려주도록 되어 있으나, 이 기능을 사용하지 않으려면 disable_alert값을 1로 하여 전송해주십시요.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[173.0]},"content":[{"type":"paragraph","content":[{"text":"redirection_scope","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[281.0]},"content":[{"type":"paragraph","content":[{"text":"‘outer’","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1233.0]},"content":[{"type":"paragraph","content":[{"text":"업로드 완료 후 redirect할 domain scope를 지정합니다. 이 옵션은 다음의 값 가운데 하나를 가질 수 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"outer → window.top.location을 이용합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"inner → window.location 을 이용합니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"no → redirect 하지 않습니다.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[173.0]},"content":[{"type":"paragraph","content":[{"text":"accept","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[281.0]},"content":[{"type":"paragraph","content":[{"text":"Request Header 가운데 Accept의 값","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1233.0]},"content":[{"type":"paragraph","content":[{"text":"업로드 완료 후 전달받을 결과의 컨텐츠 타입을 지정합니다. 빈값으로 두면 text/html 방식으로 전달합니다. 이 경우는 return_url, disable_alert, redirection_scope 옵션들을 적용하여 생성된 html 페이지가 결과로 리턴됩니다. 이 값을 ‘application/json’ 형식으로 지정하면 위 세가지 옵션은 무시되며, 결과가 JSON 형식으로 리턴됩니다.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"RETURN URL","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"result는 S와 F 두 값을 갖습니다. S는 업로드 성공을, F는 실패를 의미합니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"message는 업로드 결과를 안내하는 메세지입니다. (alert창으로 보여지는 메세지와 같습니다.)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"업로드 진행률","type":"text"}]},{"type":"paragraph","content":[{"text":"업로드 URL 생성 API 호출을 통해 획득한 결과 가운데 progress_url 엔트리를 참조하여 업로드 진행률을 획득합니다. (JSON 형식)","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"응답규격","type":"text"}]},{"type":"paragraph","content":[{"text":"application/json; charset=UTF-8 으로 결과를 반환 합니다.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"error\": 0,\n \"message\": \"\",\n \"result\": {\n \"upload_url\": \"https://upload.kr.kollus.com/api/v1/UploadMultiParts/KUS_BOHG2eTQhPSIaG2511G1jfkpWOYAOjDc/20151204-dh6o2goz\",\n “progress_url”: “https://upload.kr.kollus.com/api/v1/GetUploadingProgress/KUS_BOHG2eTQhPSIaG2511G1jfkpWOYAOjDc”,\n \"upload_file_key\": \"20141017-y4sae7td\",\n \"will_be_expired_at\": 1413883670\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"응답 결과 설명","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"error : 에러코드, 0이면 정상","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"message : 에러의 경우 상세 설명이 포함됩니다.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"result : 정상인 경우 업로드 API 호출 결과를 포함 합니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"upload_url : 업로드할 URL (HTTP)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"progress_url : 업로드 진행률을 획득할 수 있는 URL (HTTP)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"upload_file_key : 업로드 파일키","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"will_be_expired_at : upload_file_key 만료 시간 (unix timestamp)","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"에러 케이스","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","width":1800.0,"localId":"fd8ffe19-262f-45b2-ae6f-e14facdf1722"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"Status","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[606.0]},"content":[{"type":"paragraph","content":[{"text":"Result","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[501.0]},"content":[{"type":"paragraph","content":[{"text":"Cause","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Solution","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"400","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[606.0]},"content":[{"type":"paragraph","content":[{"text":"\"error\": \"1\", \"message:\": \"failed to create upload session. invalid request\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[501.0]},"content":[{"type":"paragraph","content":[{"text":"accessToken 빈값","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"accessToken을 query parameter를 넣어서 요청","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"400","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[606.0]},"content":[{"type":"paragraph","content":[{"text":"\"error\": \"1\", \"message:\": \"The Audio profile key does not exist.\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[501.0]},"content":[{"type":"paragraph","content":[{"text":"accessToken 등록이안되거나 정상적이지 않는값","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"accessToken이 올바른지 등록이 되였는지 확인","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"400","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[606.0]},"content":[{"type":"paragraph","content":[{"text":"\"error\": \"1\", \"message:\": \"The profile key does not exist.\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[501.0]},"content":[{"type":"paragraph","content":[{"text":"passthrough시 해당 profile_key이 정상적으로 받지 않았을때","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"profile_key가 body에 넣어서 요청했는지 확인","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"400","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[606.0]},"content":[{"type":"paragraph","content":[{"text":"\"error\": \"1\", \"message:\": \"The profile key does not match.\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[501.0]},"content":[{"type":"paragraph","content":[{"text":"passthrough시 해당 profile_key가 옳바르지 않을경우","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"해당 profile_key가 올바른지 확인","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"500","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[606.0]},"content":[{"type":"paragraph","content":[{"text":"{","type":"text"},{"type":"hardBreak"},{"text":" \"error\": true,","type":"text"},{"type":"hardBreak"},{"text":" \"message\": \"expired time\",","type":"text"},{"type":"hardBreak"},{"text":" \"result\": {","type":"text"},{"type":"hardBreak"},{"text":" \"type\": \"f\",","type":"text"},{"type":"hardBreak"},{"text":" \"upload_key\": \"null\",","type":"text"},{"type":"hardBreak"},{"text":" \"progress\": 0","type":"text"},{"type":"hardBreak"},{"text":" }","type":"text"},{"type":"hardBreak"},{"text":"}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[501.0]},"content":[{"type":"paragraph","content":[{"text":"expire 시간이 0이거나 또는 최대시간을 초과 하였을때","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"expire 시간을 설정을 0이상 21600이하로 설정","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"500","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[606.0]},"content":[{"type":"paragraph","content":[{"text":"{","type":"text"},{"type":"hardBreak"},{"text":" \"error\": true,","type":"text"},{"type":"hardBreak"},{"text":" \"message\": \"bad parameters\",","type":"text"},{"type":"hardBreak"},{"text":" \"result\": {","type":"text"},{"type":"hardBreak"},{"text":" \"type\": \"p\",","type":"text"},{"type":"hardBreak"},{"text":" \"upload_key\": \"null\",","type":"text"},{"type":"hardBreak"},{"text":" \"progress\": 0","type":"text"},{"type":"hardBreak"},{"text":" }","type":"text"},{"type":"hardBreak"},{"text":"}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[501.0]},"content":[{"type":"paragraph","content":[{"text":"upload Type의 값이 올바르지 않을경우","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"uploadType을 n 또는 f 로 원하는값을 맞춰야 함","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"200","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[606.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[501.0]},"content":[{"type":"paragraph","content":[{"text":"upload 실패","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"uploadUri을 정확하게 다시 확인후 파일을업로드해야하며, form-data의 filed가 upload-file인데 정확하게 작성해서 보냈는지 확인","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"샘플코드","type":"text"}]},{"type":"paragraph","content":[{"text":"Upload API – ruby","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/kollus-service/kollus-custom-upload-ruby"}}]}]},{"type":"paragraph","content":[{"text":"Upload API – jquery","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/kollus-service/kollus-custom-upload-jquery"}}]}]},{"type":"paragraph","content":[{"text":"Upload API – php","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/kollus-service/kollus-custom-upload-php"}}]}]},{"type":"paragraph","content":[{"text":"Upload API – java","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/kollus-service/kollus-sample-java"}}]}]}],"version":1}

Browser not supported