업로드 토큰

자막 파일 업로드를 위한 토큰을 요청 합니다.

Request URL

GET https://api.v4.wecandeo.com/info/videopack/caption/v1/upload/token.json?accessKey={Access Key}

Parameter Name	Type	Description
accessKey (Required)	String	자막과 매칭할 동영상의 원본 키 (Access Key)

{
  "ver": "v1",
  "uploadUrl": "{Upload URL}",
  "token": "{Token}"
}

❗️
주의

Upload URL은 언제든지 변경이 될 수 있으므로, 고정된 값으로 사용하지 않도록 합니다.

Token의 유효 시간은 발급 후 5분까지입니다.

업로드 토큰을 이용하여 동영상에 자막 파일을 추가 업로드합니다.

multipart/form data를 이용한 업로드 방식입니다.

한개의 동영상에 언어 구분에 따라 여러개의 자막 업로드가 가능합니다.
언어 구분은 자막 언어 코드 조회 API 를 이용하여 ID를 조회할 수 있습니다.

자막 파일 형식은 HTML5 플레이어에서의 자막 사용을 위해 WebVTT(.vtt 확장자 파일)만 지원합니다.
브라우저에 따라 WebVTT에서 정의된 위치 지정 또는 스타일 지정 속성 중 일부가 지원되지 않을 수 있습니다.

자막 파일 업로드 시 accessKey와 langId가 동일한 기존 파일이 이미 존재하는 경우에는 신규 업로드 파일로 교체됩니다.

POST {captionUploadUrl}?token={token}

Parameter Name	Type	Description
token (Required)	String	(자막 파일) 업로드 토큰에서 조회한 토큰 값
langId	Integer	자막 파일 언어코드 조회에서 조회한 자막 언어 코드 ID - 미입력 시 langId는 10000(한국어)으로 설정
captionType	String	자막 유형 - STANDARD : 일반 자막 - SDH : 청각 장애인용 자막 e.g., 청각 장애인용 자막인 경우 `&captionType=SDH` 설정 필요 - 미입력 시 일반 자막으로 설정

Parameter Name	Type	Description
file (Required)	File (multipart/form)	업로드 할 자막 파일 데이터

{
	"isSuccess": true
}