빠른 시작: Zencoder

Zencoder의 핵심은 인코딩 서비스입니다. 주문형 비디오 (VOD) 콘텐츠를 입력으로 가져 오면 Zencoder는이를 인코딩하여 지정한 형식 및 기타 설정으로 출력을 생성하고 원하는 대상으로 전달합니다. 이 소개에서는 기본 작업을 제출하는 방법을 배웁니다.

젠코더 API

모든 작업은 Zencoder API를 사용하여 수행됩니다. 있지만요청 빌더몇 가지 기본 API 요청을 시도하는 데 사용할 수 있으므로 곧 API에 직접 액세스하는 단계로 넘어갈 것입니다. 이 가이드에서는 아래 표시된 cURL 명령 또는 다음과 같은 REST API 클라이언트를 수정하고 사용할 수 있습니다. 우편 집배원 .

cURL에 익숙하지 않은 경우 cURL 설정 .

요청을하다

작업 제출 요청은POST전송 된 요청 :

https://app.zencoder.com/api/v2/jobs

필수 헤더

요청과 함께 보내야하는 두 개의 헤더가 있습니다.

  • Zencoder-Api-Key: YOUR_API_KEY
  • Content-Type: application/json

다음을 방문하여 API 키를 얻을 수 있습니다. https://app.zencoder.com/api . 이 연습에서는 전체 액세스 또는 통합 전용 키를 사용할 수 있습니다.

추가 정보

요청에는 출력 대상, 알림 설정 및 트랜스 코딩 설정을 포함하여 작업에 대한 출력 설정이 포함될 수 있으며 일반적으로 포함될 수 있습니다. 이 간단한 연습에서는이 부분을 건너 뛰 겠지만 자세한 내용은인코딩 설정 .

현재 다음을 사용하여 파일 다운로드를 지원합니다. HTTP / HTTPS, S3, 클라우드 파일, FTP / FTPS, SFTP 및 Aspera .

간단한 새 작업 요청은 본문에 입력 파일의 URL과 계정의 URL을 지정하기 만하면됩니다. API 키헤더에Zencoder-Api-Key .

  {
  "input": "s3://zencodertesting/test.mov"
  }

다음과 같이 테스트 할 수 있습니다. 곱슬 곱슬하다명령.

  curl --header "Zencoder-Api-Key: YOUR_API_KEY" \
       --header "Content-Type: application/json" \
       --data '{"input":"s3://zencodertesting/test.mov"}' \
       https://app.zencoder.com/api/v2/jobs

이 코드를 텍스트 편집기에 복사하고 YOUR_API_KEY API 키로. 그런 다음 명령 프롬프트를 열고 명령 프롬프트에서 cURL 명령을 복사하여 붙여 넣은 다음 Return (Enter) 키를 누릅니다.

Windows 사용자를위한 참고 사항 : Windows에서 cURL의 제한으로 인해 다음과 같은 큰 따옴표를 이스케이프해야합니다. \"그리고 포장--data작은 따옴표 대신 큰 따옴표로 묶인 콘텐츠.

이 요청은 계정에 대한 인코딩 작업을 만들고 s3 : //zencodertesting/test.mov에있는 파일을 기본 출력 대상으로 다운로드 및 트랜스 코딩하려고 시도합니다.

대응

API를 통해 새 인코딩 작업을 생성하면 서버가 즉시 생성되는 작업 및 출력 파일에 대한 세부 정보로 응답합니다. 인코딩 프로세스를 통해 추적하려면 작업 및 출력 ID를 저장해야합니다. 참고id 64 비트 범위의 정수입니다.

데이터는 JSON 형식으로 반환됩니다.

이전의 새 인코딩 작업 예제는 다음을 반환합니다. 201 Created상태 코드.

  {
    "id": 366118847,
    "outputs": [
      {
        "id": 1297606670,
        "label": null,
        "url": "https://zencoder-temp-storage-us-east-1.s3.amazonaws.com/o/20170422/69a1a537e5b40f91c172e6b033827159/9ea8d51bc1a71545eb9c700c0379e950.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAI456JQ76GBU7FECA%2F20170422%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170422T214927Z&X-Amz-Expires=86399&X-Amz-SignedHeaders=host&X-Amz-Signature=9c0b05565dabcd5d7405a882956ef2babff6173c80cbafa36b2bd12df569e594"
      }
    ]
  }

참고: 입력 파일이 존재하지 않고 출력 위치가 유효하지 않으며 파일 자체가 , 또는 다른 이유 .