「クイックスタート:Zencoder

Zencoder API

すべての操作は Zencoder API を使用して実行されます。いくつかの基本的な API リクエストを試すことができるリクエストビルダーがありますが、すぐに API に直接アクセスするようになります。このガイドでは、以下に示す cURL コマンド、または Postman などの REST API クライアントを変更して使用できます。

cURL に慣れていない場合は、cURL の設定を参照してください。

リクエストする

ジョブを送信するリクエストは、POST次の宛先に送信されるリクエストです。

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

必要なヘッダー

リクエストと一緒に送信する必要があるヘッダーは 2 つあります。

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

https://app.zencoder.com/api にアクセスして API キーを取得できます。この演習では、[フルアクセス] キーまたは [統合のみ] キーを使用できます。

詳細情報

要求には、出力先、通知設定、トランスコーディング設定など、ジョブの出力設定が含まれる場合があります (通常は)。この簡単な演習では、これをスキップしますが、エンコーディング設定で詳細を確認することができます。

現在、 HTTP/HTTPS、S3、クラウドファイル、FTP/FTPS、SFTP、Aspera を使用したファイルのダウンロードをサポートしています。

単純な新しいジョブリクエストでは、本文内の入力ファイルの URL と、というヘッダーにアカウントの API Zencoder-Api-Keyキーを指定するだけで済みます。

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

これをテストするには、次の cURLコマンドを使用します。

  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"
      }
    ]
  }

注: < a href=」/error-トラブルシューティング/エラーコード/error-filenotfounderror.html>入力ファイルが存在しないため、ジョブが失敗する可能性がある < /a>、 < a href=」/error-トラブルシューティング/エラーコード/エラー-uploadservernotfounderror.html>出力の場所が無効です。ファイル自体はhref=」/error-トラブルシューティング/エラーコード/エラーコード/エラー-nomediaerror.html>有効なビデオまたはオーディオファイルではありません "」 < 、またはその他の理由がある。